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

Open
t-d-aleksandrov-edu-mtuci-ru wants to merge 3 commits from t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab3:lab3-implementation into main
First-time contributor

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

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

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

  • Перенесено из lab2: PostgreSQL источник истины, Valkey кэш сессий, Argon2id, Bearer-сессии, транзакционное создание чата, keyset-пагинация, circuit breaker
  • Новое в lab3: 2 API-реплики (api-1, api-2) с уникальным INSTANCE_ID; Nginx load balancer с health-check и failover; Idempotency-Key в заголовке (replay возвращает исходное сообщение); X-Instance-Id в каждом ответе; /version и /info эндпоинты; housekeeping-loop для очистки истёкших сессий и ключей; таблица idempotency_keys с миграциями 004, 005, 006
  • Исправлены импорты config/models/api/store/sessions
  • Скрипты: stop-one.sh/cmd (failover), restart.sh/cmd (persistence)

Команды запуска из чистого 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:8081
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8081
python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8081
cd student-tests && BASE_URL=http://127.0.0.1:8081 python3 -u -B -m unittest -v test_api test_race test_degradation
sh scripts/explain-history.sh

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

  • Smoke: PASS: lab3 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)
  • Failover: PASS — 79 успешных записей из 83, восстановление за 2.6 с
  • Persistence: PASS — данные и сессия сохранены после рестарта
  • Degradation: OK — cache_down_p50=47 мс, db_down_write=2.05 с, recovery=1.97 с
  • Подробности: REPORT.md

Ограничения

  • На Windows .sh-скрипты не запускаются напрямую (WinError 193); созданы эквиваленты .cmd
  • Локальный кэш отозванных токенов не разделяется между репликами (уровень 5 не заявлен)
  • Нагрузочный тест закрытого цикла содержит coordinated omission

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

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

## Лабораторная 3 Автор / группа: Тимофей Александров, БВТ2301 Целевая оценка: 4 Трек 5: не заявлен ### Что реализовано - Перенесено из lab2: PostgreSQL источник истины, Valkey кэш сессий, Argon2id, Bearer-сессии, транзакционное создание чата, keyset-пагинация, circuit breaker - Новое в lab3: 2 API-реплики (api-1, api-2) с уникальным INSTANCE_ID; Nginx load balancer с health-check и failover; Idempotency-Key в заголовке (replay возвращает исходное сообщение); X-Instance-Id в каждом ответе; /version и /info эндпоинты; housekeeping-loop для очистки истёкших сессий и ключей; таблица idempotency_keys с миграциями 004, 005, 006 - Исправлены импорты config/models/api/store/sessions - Скрипты: stop-one.sh/cmd (failover), restart.sh/cmd (persistence) ### Команды запуска из чистого 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:8081 python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8081 python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8081 cd student-tests && BASE_URL=http://127.0.0.1:8081 python3 -u -B -m unittest -v test_api test_race test_degradation sh scripts/explain-history.sh ### Результаты проверок - Smoke: PASS: lab3 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) - Failover: PASS — 79 успешных записей из 83, восстановление за 2.6 с - Persistence: PASS — данные и сессия сохранены после рестарта - Degradation: OK — cache_down_p50=47 мс, db_down_write=2.05 с, recovery=1.97 с - Подробности: REPORT.md ### Ограничения - На Windows .sh-скрипты не запускаются напрямую (WinError 193); созданы эквиваленты .cmd - Локальный кэш отозванных токенов не разделяется между репликами (уровень 5 не заявлен) - Нагрузочный тест закрытого цикла содержит coordinated omission ### Источники и ИИ README/COURSE/CONTRIBUTING, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey, Nginx; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
t-d-aleksandrov-edu-mtuci-ru added 1 commit 2026-10-30 21:51:17 +03:00
- 2 API-реплики (api-1, api-2) с уникальным INSTANCE_ID
- Nginx load balancer с health-check и failover
- PostgreSQL источник истины, Valkey кэш сессий
- Idempotency-Key в заголовке, replay возвращает исходное сообщение
- X-Instance-Id в каждом ответе для идентификации реплики
- /version и /info эндпоинты
- Housekeeping-loop для очистки истёкших сессий и ключей
- stop-one.sh/cmd для failover-теста, restart.sh/cmd для persistence
- Исправлены импорты config/models/api/store/sessions
- Добавлены миграции 004 (idempotency), 005 (indexes), 006 (message_id)
- Отчёт с доказательствами критериев уровня 3 и 4
- Все тесты проходят: smoke, 26 student tests, failover, persistence, degradation
Owner

Существенные проблемы уровня 3:

  1. Глобальная область Idempotency-Key возвращает чужое сообщение. Пользователь A отправляет сообщение в чат A с ключом K. Пользователь E, не имеющий доступа к этому чату, отправляет такой же текст с K в собственный чат E. Ожидается новая независимая запись; фактически возвращается 201 с исходными id, chat_id и sender_id сообщения A. Прямое чтение чужого чата при этом правильно возвращает 404. Другой текст в независимой области ошибочно получает 409. Причина — поиск и replay только по ключу: src/api.py:337.
  2. Конкурентный повтор даёт внутреннюю ошибку. Один естественный залп из 32 одинаковых POST через обе реплики дал 31 × 201, 1 × 500. Сообщение создано одно, дублей нет, однако ожидаются одинаковые 201 с исходным Message. После конфликта INSERT обработчик повторно читает через ту же транзакцию без восстановления её состояния: src/api.py:349.
  3. Отозванная сессия снова принимается другой репликой после восстановления кэша. Прогреть токен, остановить Valkey, выполнить logout через api-1: получен 204, в PostgreSQL отзыв сохранён. Затем восстановить Valkey с прежним томом и переподключить кэш на api-2 запросом с другой действующей сессией. Адресная проверка старого токена на api-2 получила 200 вместо 401. Cache-hit возвращает пользователя без проверки отзыва в PostgreSQL, а отложенный отзыв остаётся локальным: src/sessions.py:275. Это требование обязательного контракта уровня 3.
Существенные проблемы уровня 3: 1. Глобальная область Idempotency-Key возвращает чужое сообщение. Пользователь A отправляет сообщение в чат A с ключом K. Пользователь E, не имеющий доступа к этому чату, отправляет такой же текст с K в собственный чат E. Ожидается новая независимая запись; фактически возвращается 201 с исходными id, chat_id и sender_id сообщения A. Прямое чтение чужого чата при этом правильно возвращает 404. Другой текст в независимой области ошибочно получает 409. Причина — поиск и replay только по ключу: [src/api.py:337](https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab3/src/commit/e084a29303dcce84df6b22007bb5e99118d28138/src/api.py#L337). 2. Конкурентный повтор даёт внутреннюю ошибку. Один естественный залп из 32 одинаковых POST через обе реплики дал 31 × 201, 1 × 500. Сообщение создано одно, дублей нет, однако ожидаются одинаковые 201 с исходным Message. После конфликта INSERT обработчик повторно читает через ту же транзакцию без восстановления её состояния: [src/api.py:349](https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab3/src/commit/e084a29303dcce84df6b22007bb5e99118d28138/src/api.py#L349). 3. Отозванная сессия снова принимается другой репликой после восстановления кэша. Прогреть токен, остановить Valkey, выполнить logout через api-1: получен 204, в PostgreSQL отзыв сохранён. Затем восстановить Valkey с прежним томом и переподключить кэш на api-2 запросом с другой действующей сессией. Адресная проверка старого токена на api-2 получила 200 вместо 401. Cache-hit возвращает пользователя без проверки отзыва в PostgreSQL, а отложенный отзыв остаётся локальным: [src/sessions.py:275](https://gitea.privcloud.tech/t-d-aleksandrov-edu-mtuci-ru/mtusi2026lab3/src/commit/e084a29303dcce84df6b22007bb5e99118d28138/src/sessions.py#L275). Это требование обязательного контракта уровня 3.
t-d-aleksandrov-edu-mtuci-ru added 2 commits 2026-11-06 17:40:05 +03:00
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/mtusi2026lab3 lab3-implementation:t-d-aleksandrov-edu-mtuci-ru-lab3-implementation
git checkout t-d-aleksandrov-edu-mtuci-ru-lab3-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/mtusi2026lab3#81