diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8ceefa10..e5cca5b6 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,49 @@ ## Лабораторная 2 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Тимофей Александров, БВТ2301 +Целевая оценка (3/4/5): 4 +Трек 5, если заявлен: не заявлен -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Что реализовано и что перенесено: +- Перенесено из lab1: контракт API, keyset-пагинация, health-эндпоинты, регистрация пользователей. +- Новое в lab2: PostgreSQL источник истины (миграции 001-003), Valkey кэш сессий, Argon2id пароли, Basic только на POST /auth/sessions, Bearer на остальных эндпоинтах, транзакционное создание чата, idempotency-ключи, circuit breaker на Valkey, graceful degradation при отказе кэша/БД, bounded connection pool с таймаутами. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Команды запуска из чистого 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 содержит инструкцию именно моего решения.