ЛР 2 — БВТ2301 — Александров— на 4 #140

Open
t-d-aleksandrov-edu-mtuci-ru wants to merge 3 commits from t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab2:lab2-implementation into master
First-time contributor

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

Автор / группа: Тимофей Александров, БВТ2301
Целевая оценка: 4
Трек 5: не заявлен

Что реализовано

  • PostgreSQL источник истины (миграции 001-003), Valkey кэш сессий (TTL 300 с, tombstone при logout)
  • Argon2id пароли, Basic только на POST /auth/sessions, Bearer на остальных
  • Транзакционное создание чата (откат при неизвестном участнике)
  • Idempotency-ключи, keyset-пагинация по (created_at, id)
  • Circuit breaker на Valkey (5 с cooldown), graceful degradation при отказе кэша/БД
  • Bounded connection pool (1-10), statement_timeout=5000, lock_timeout=2000
  • Docker Compose: api, postgres, valkey; секреты через файлы (mode 0600)
  • Скрипты: bootstrap-secrets, restart.sh/cmd, test-ttl.sh, explain-history.sh

Команды запуска из чистого clone

sh scripts/bootstrap-secrets.sh
docker compose --env-file .env up -d --build --wait --wait-timeout 180
python3 scripts/check_contract.py
python3 scripts/validate_openapi.py
python3 tests/smoke.py --base-url http://127.0.0.1:8080
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080
cd student-tests && BASE_URL=http://127.0.0.1:8080 python3 -u -B -m unittest -v test_api test_race test_degradation
sh scripts/test-ttl.sh
sh scripts/explain-history.sh

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

  • Smoke: PASS: lab2 public API scenario
  • check_contract: PASS: offline skeleton structure, local refs and Python syntax
  • validate_openapi: PASS: full OpenAPI 3.1 and JSON Schema validation
  • Student tests: 26/26 OK (duplicate_username_race, chat_creation_rolls_back, bounded_pool)
  • Persistence: PASS: persistence preserved confirmed data and existing session
  • TTL: 4/4 OK, 6.1 с (стенд SESSION_TTL_SECONDS=2, :8081)
  • Degradation: OK — cached_p50=16 мс, cache_down_p50=39 мс, cache_down_p95=78 мс
  • EXPLAIN: 12 000 сообщений, Index Scan, 4 буфера, 0.208 мс
  • Нагрузка: 25.5 rps, 523 запроса, 0 ошибок, p50 125 мс, p95 328 мс
  • Подробности: REPORT.md

Ограничения

  • Один процесс api: локальный кэш и circuit breaker не разделяются между репликами (решено в lab3)
  • Нагрузочный тест закрытого цикла содержит coordinated omission
  • make в среде отсутствует, команды выполнялись напрямую

Источники и ИИ

README/COURSE/CONTRIBUTING, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.

## Лабораторная 2 Автор / группа: Тимофей Александров, БВТ2301 Целевая оценка: 4 Трек 5: не заявлен ### Что реализовано - PostgreSQL источник истины (миграции 001-003), Valkey кэш сессий (TTL 300 с, tombstone при logout) - Argon2id пароли, Basic только на POST /auth/sessions, Bearer на остальных - Транзакционное создание чата (откат при неизвестном участнике) - Idempotency-ключи, keyset-пагинация по (created_at, id) - Circuit breaker на Valkey (5 с cooldown), graceful degradation при отказе кэша/БД - Bounded connection pool (1-10), statement_timeout=5000, lock_timeout=2000 - Docker Compose: api, postgres, valkey; секреты через файлы (mode 0600) - Скрипты: bootstrap-secrets, restart.sh/cmd, test-ttl.sh, explain-history.sh ### Команды запуска из чистого clone sh scripts/bootstrap-secrets.sh docker compose --env-file .env up -d --build --wait --wait-timeout 180 python3 scripts/check_contract.py python3 scripts/validate_openapi.py python3 tests/smoke.py --base-url http://127.0.0.1:8080 python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080 cd student-tests && BASE_URL=http://127.0.0.1:8080 python3 -u -B -m unittest -v test_api test_race test_degradation sh scripts/test-ttl.sh sh scripts/explain-history.sh ### Результаты проверок - Smoke: PASS: lab2 public API scenario - check_contract: PASS: offline skeleton structure, local refs and Python syntax - validate_openapi: PASS: full OpenAPI 3.1 and JSON Schema validation - Student tests: 26/26 OK (duplicate_username_race, chat_creation_rolls_back, bounded_pool) - Persistence: PASS: persistence preserved confirmed data and existing session - TTL: 4/4 OK, 6.1 с (стенд SESSION_TTL_SECONDS=2, :8081) - Degradation: OK — cached_p50=16 мс, cache_down_p50=39 мс, cache_down_p95=78 мс - EXPLAIN: 12 000 сообщений, Index Scan, 4 буфера, 0.208 мс - Нагрузка: 25.5 rps, 523 запроса, 0 ошибок, p50 125 мс, p95 328 мс - Подробности: REPORT.md ### Ограничения - Один процесс api: локальный кэш и circuit breaker не разделяются между репликами (решено в lab3) - Нагрузочный тест закрытого цикла содержит coordinated omission - make в среде отсутствует, команды выполнялись напрямую ### Источники и ИИ README/COURSE/CONTRIBUTING, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
t-d-aleksandrov-edu-mtuci-ru added 1 commit 2026-10-30 21:56:28 +03:00
Owner

[P1] Отозванный токен снова получает доступ после восстановления кэша.
Минимальное воспроизведение: войти и прогреть кэш → остановить Valkey → выполнить logout → перезапустить API → запустить Valkey → обратиться с прежним токеном. Logout вернул 204, PostgreSQL сохранил отзыв; до рестарта токен получал 401. После восстановления тот же токен получил 200 на /users/me и историю, 201 на отправку сообщения. Ожидается 401 во всех случаях. Недоставленный отзыв остаётся в памяти процесса, а попадание в кэш разрешает доступ без проверки PostgreSQL: src/sessions.py:221, src/sessions.py:281.

[P1] Отозванный токен снова получает доступ после восстановления кэша. Минимальное воспроизведение: войти и прогреть кэш → остановить Valkey → выполнить logout → перезапустить API → запустить Valkey → обратиться с прежним токеном. Logout вернул 204, PostgreSQL сохранил отзыв; до рестарта токен получал 401. После восстановления тот же токен получил 200 на /users/me и историю, 201 на отправку сообщения. Ожидается 401 во всех случаях. Недоставленный отзыв остаётся в памяти процесса, а попадание в кэш разрешает доступ без проверки PostgreSQL: [src/sessions.py:221](https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab2/src/commit/3df9b09896e8e9e23e9e86007e4cfea147c2380a/src/sessions.py#L221), [src/sessions.py:281](https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab2/src/commit/3df9b09896e8e9e23e9e86007e4cfea147c2380a/src/sessions.py#L281).
t-d-aleksandrov-edu-mtuci-ru added 2 commits 2026-11-06 17:39:32 +03:00
Some required checks failed
1 workflow awaiting approval

The workflow will only run after approval from the repository maintainer.

Skeleton contracts / contracts (pull_request) Canceled after 0s
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab2 lab2-implementation:t-d-aleksandrov-edu-mtuci-ru-lab2-implementation
git checkout t-d-aleksandrov-edu-mtuci-ru-lab2-implementation
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#140