ЛР 2 - БПИ2301 - Антонова - на 4 #90

Closed
k00kza wants to merge 3 commits from k00kza/mtusi2026lab2-fork:solution/BPI2301-Antonova into master
First-time contributor

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

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

Что реализовано и что перенесено: Реализовано REST API на FastAPI с персистентным хранением в PostgreSQL (пользователи, чаты, участники, сообщения и сессии) и кэшированием сессий в Redis. Добавлена регистрация с хешированием паролей (scrypt), аутентификация по схеме Basic/Bearer, управление сроком жизни сессий (TTL), атомарное создание чатов, keyset-пагинация истории сообщений, а также отказоустойчивость при падении Redis или базы данных.
Команды запуска из чистого clone:

cp env.lab2.template .env
docker compose --env-file .env up -d --build
curl http://localhost:8080/health/ready
python tests/smoke.py --base-url "http://localhost:8080"
$env:ACTION_SCRIPT="scripts/restart.sh"
python tests/resilience.py --mode persistence --action-script "$env:ACTION_SCRIPT" --base-url "http://localhost:8080"
docker compose --env-file .env --profile test run --rm --build tests

Результаты проверок и ссылка на REPORT.md: Все проверки, включая публичный smoke-тест, тесты на персистентность данных при рестартах и более 150 собственных студенческих тестов (make test-student), завершились успешно. Подробный отчёт со всеми доказательствами доступен в файле REPORT.md.
Ограничения / известные ошибки:

  • Работа в одном экземпляре API, PostgreSQL и Redis (без репликации и бэкапов).
  • Redis функционирует без пароля (доступен только внутри сети docker compose), трафик без TLS.
  • В случае сбоя Redis во время logout кэш очищается локально в рамках конкретного экземпляра API.
  • Для хеширования паролей применяется scrypt вместо Argon2id.
    Источники и использование ИИ: FastAPI, SQLAlchemy (async) + asyncpg, Pydantic, uvicorn, redis-py, pytest, httpx; при написании кода и структурировании проекта использовался ИИ-ассистент (Claude).
  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Антонова Ирина Андреевна БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: Реализовано REST API на FastAPI с персистентным хранением в PostgreSQL (пользователи, чаты, участники, сообщения и сессии) и кэшированием сессий в Redis. Добавлена регистрация с хешированием паролей (scrypt), аутентификация по схеме Basic/Bearer, управление сроком жизни сессий (TTL), атомарное создание чатов, keyset-пагинация истории сообщений, а также отказоустойчивость при падении Redis или базы данных. Команды запуска из чистого clone: ```sh cp env.lab2.template .env docker compose --env-file .env up -d --build curl http://localhost:8080/health/ready python tests/smoke.py --base-url "http://localhost:8080" $env:ACTION_SCRIPT="scripts/restart.sh" python tests/resilience.py --mode persistence --action-script "$env:ACTION_SCRIPT" --base-url "http://localhost:8080" docker compose --env-file .env --profile test run --rm --build tests ``` Результаты проверок и ссылка на REPORT.md: Все проверки, включая публичный smoke-тест, тесты на персистентность данных при рестартах и более 150 собственных студенческих тестов (`make test-student`), завершились успешно. Подробный отчёт со всеми доказательствами доступен в файле REPORT.md. Ограничения / известные ошибки: * Работа в одном экземпляре API, PostgreSQL и Redis (без репликации и бэкапов). * Redis функционирует без пароля (доступен только внутри сети docker compose), трафик без TLS. * В случае сбоя Redis во время logout кэш очищается локально в рамках конкретного экземпляра API. * Для хеширования паролей применяется scrypt вместо Argon2id. Источники и использование ИИ: FastAPI, SQLAlchemy (async) + asyncpg, Pydantic, uvicorn, redis-py, pytest, httpx; при написании кода и структурировании проекта использовался ИИ-ассистент (Claude). * [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. * [x] Контракт и публичные тесты не ослаблены. * [x] make check и make test выполнены; приложен реальный вывод. * [x] Сценарии отказов/безопасности своего уровня воспроизведены. * [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. * [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
k00kza added 3 commits 2026-10-23 14:42:21 +03:00
Обновить REPORT.md
Skeleton contracts / contracts (pull_request) Canceled after 0s
6aa9bd6a06
Owner

Подтверждённые проблемы:

  1. Отозванный токен снова получает доступ после рестарта API. Минимальное воспроизведение: войти и прогреть кэш; разорвать связь с Redis, сохранив его память; выполнить logout → 204; перезапустить только API; вернуть Redis в сеть. Ожидается 401. Фактически /api/v1/users/me вернул 200, отправка сообщения — 201, сообщение действительно записалось в PostgreSQL. Сессии в БД уже не было, у старого ключа Redis оставалось около 57,6 секунды TTL.
    Причина: признак потерянной инвалидации хранится только в памяти — app/cache.py:104, после старта сбрасывается — app/cache.py:45. Положительный кэш принимается без проверки PostgreSQL — app/auth.py:87. Без рестарта API очистка при восстановлении связи прошла успешно. Заявленное ограничение локального флага не отменяет контракт отзыва.
  2. Некорректная временная метка cursor вызывает 500. В cursor своего чата задать t=10**30, сохранив корректные s и i, затем выполнить GET истории. Ожидается 400 invalid_request, фактически — 500 internal_error. Верхняя граница отсутствует в app/cursor.py:41; преобразование заканчивается OverflowError в app/timeutil.py:20.
Подтверждённые проблемы: 1. Отозванный токен снова получает доступ после рестарта API. Минимальное воспроизведение: войти и прогреть кэш; разорвать связь с Redis, сохранив его память; выполнить logout → 204; перезапустить только API; вернуть Redis в сеть. Ожидается 401. Фактически /api/v1/users/me вернул 200, отправка сообщения — 201, сообщение действительно записалось в PostgreSQL. Сессии в БД уже не было, у старого ключа Redis оставалось около 57,6 секунды TTL. Причина: признак потерянной инвалидации хранится только в памяти — [app/cache.py:104](https://gitea.privcloud.tech/k00kza/mtusi2026lab2-fork/src/commit/6aa9bd6a066207be9a39a0665d3028950828cf92/app/cache.py#L104), после старта сбрасывается — [app/cache.py:45](https://gitea.privcloud.tech/k00kza/mtusi2026lab2-fork/src/commit/6aa9bd6a066207be9a39a0665d3028950828cf92/app/cache.py#L45). Положительный кэш принимается без проверки PostgreSQL — [app/auth.py:87](https://gitea.privcloud.tech/k00kza/mtusi2026lab2-fork/src/commit/6aa9bd6a066207be9a39a0665d3028950828cf92/app/auth.py#L87). Без рестарта API очистка при восстановлении связи прошла успешно. Заявленное ограничение локального флага не отменяет контракт отзыва. 2. Некорректная временная метка cursor вызывает 500. В cursor своего чата задать t=10**30, сохранив корректные s и i, затем выполнить GET истории. Ожидается 400 invalid_request, фактически — 500 internal_error. Верхняя граница отсутствует в [app/cursor.py:41](https://gitea.privcloud.tech/k00kza/mtusi2026lab2-fork/src/commit/6aa9bd6a066207be9a39a0665d3028950828cf92/app/cursor.py#L41); преобразование заканчивается OverflowError в [app/timeutil.py:20](https://gitea.privcloud.tech/k00kza/mtusi2026lab2-fork/src/commit/6aa9bd6a066207be9a39a0665d3028950828cf92/app/timeutil.py#L20).
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-24 16:16:25 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#90