Files
mtusi2026lab2/.github/pull_request_template.md
T

50 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 2
Автор / группа: Тимофей Александров, БВТ2301
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено:
- Перенесено из lab1: контракт API, keyset-пагинация, health-эндпоинты, регистрация пользователей.
- Новое в lab2: PostgreSQL источник истины (миграции 001-003), Valkey кэш сессий, Argon2id пароли, Basic только на POST /auth/sessions, Bearer на остальных эндпоинтах, транзакционное создание чата, idempotency-ключи, circuit breaker на Valkey, graceful degradation при отказе кэша/БД, bounded connection pool с таймаутами.
Команды запуска из чистого clone:
```sh
sh scripts/bootstrap-secrets.sh
docker compose --env-file .env config --quiet
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
```
Результаты проверок и ссылка на REPORT.md:
- 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 этого skeleton, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.