53 lines
4.6 KiB
Markdown
53 lines
4.6 KiB
Markdown
## Лабораторная 2
|
||
|
||
Автор / группа: Тимофей Александров, БВТ2301
|
||
Целевая оценка (3/4/5): 5
|
||
Трек 5: трек 2 «План запроса и восстановление»
|
||
|
||
Что реализовано и что перенесено:
|
||
- Перенесено из lab1: контракт API, keyset-пагинация, health-эндпоинты, регистрация пользователей.
|
||
- Новое в lab2: PostgreSQL источник истины (миграции 001-003), Valkey кэш сессий, Argon2id пароли, Basic только на POST /auth/sessions, Bearer на остальных эндпоинтах, транзакционное создание чата, idempotency-ключи, circuit breaker на Valkey, graceful degradation при отказе кэша/БД, bounded connection pool с таймаутами.
|
||
- Исправлено по ревью: Valkey больше не авторизует cache-hit самостоятельно. Каждая Bearer-сессия подтверждается в PostgreSQL, поэтому токен, отозванный при outage кэша, остаётся 401 после рестарта API и возврата старого Valkey-тома.
|
||
|
||
Команды запуска из чистого 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
|
||
sh scripts/research-history-backup.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; degradation 2/2 OK, включая durable logout после cache outage/API restart
|
||
- 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 мс
|
||
- Трек 5: 100 000 сообщений в 101 чате (90 000/100); composite index 0.128 мс / 6 buffers, chat-only 89.728 мс / 1525 buffers; backup/restore aggregates совпали.
|
||
- Нагрузка: 25.5 rps, 523 запроса, 0 ошибок, p50 125 мс, p95 328 мс
|
||
- Подробности: REPORT.md
|
||
|
||
Ограничения / известные ошибки:
|
||
- Один процесс api; репликация API — область следующей лабораторной.
|
||
- Нагрузочный тест закрытого цикла содержит 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 содержит инструкцию именно моего решения.
|