Автор / группа: Тимофей Александров, БВТ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
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) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
Глобальная область Idempotency-Key возвращает чужое сообщение. Пользователь A отправляет сообщение в чат A с ключом K. Пользователь E, не имеющий доступа к этому чату, отправляет такой же текст с K в собственный чат E. Ожидается новая независимая запись; фактически возвращается 201 с исходными id, chat_id и sender_id сообщения A. Прямое чтение чужого чата при этом правильно возвращает 404. Другой текст в независимой области ошибочно получает 409. Причина — поиск и replay только по ключу: src/api.py:337.
Конкурентный повтор даёт внутреннюю ошибку. Один естественный залп из 32 одинаковых POST через обе реплики дал 31 × 201, 1 × 500. Сообщение создано одно, дублей нет, однако ожидаются одинаковые 201 с исходным Message. После конфликта INSERT обработчик повторно читает через ту же транзакцию без восстановления её состояния: src/api.py:349.
Отозванная сессия снова принимается другой репликой после восстановления кэша. Прогреть токен, остановить 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.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 3
Автор / группа: Тимофей Александров, БВТ2301
Целевая оценка: 4
Трек 5: не заявлен
Что реализовано
Команды запуска из чистого 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
Результаты проверок
Ограничения
Источники и ИИ
README/COURSE/CONTRIBUTING, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey, Nginx; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
Существенные проблемы уровня 3:
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.