7.8 KiB
Отчёт — лабораторная 2
- Автор, группа: Синюк Максим Павлович, БПИ2301
- Целевая оценка; выбранный трек 5, если нужен: 4
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: перенос базы лаб1, python, fastapi, uvicorn, pydantic, pytest, sqlalchemy, argon2-cffi, redis
Запуск из чистого clone
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
git clone -b "solution/БПИ2301-Синюк" https://gitea.privcloud.tech/Atelier77/mtusi2026lab2 docker compose build docker compose up -d docker stop mtusi2026lab2-api
Архитектура и решения
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
описание классов для работы с таблицами БД через ORM - src/api/repositories/ модели ORM таблиц для PostgreSQL - src/models/ валидация - src/pydantic_valid/
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | make test | PASS: lab1 public API scenario; infrastructure and grading evidence remain separate. | results/make.log |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Проверка контрактов | python scripts/check_contract.py | PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. | results/check_contract.log |
| Валидация openapi | python scripts/check_contract.py | PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. | results/validate_openapi.log |
| Собственные тесты | python -m pytest student_tests -v |
20 passed | results/pytest.log |
| Нагрузочный тест | `python tests/load.py --duration 30 --concurrency 10 | ~100 req, 0 errors | results/load.json |
| Проверка нагрузки | python tests/load.py | Latency percentiles cover successes only. | results/test_load.log |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | | Индекс истории обоснован запросом и EXPLAIN (ANALYZE, BUFFERS) на ≥10 000 сообщениях| docker compose exec api python -m scripts.explain_messages | Индекс в десятки раз уменьшает latency запроса | results/explain_comparison.txt | Выбранный трек 5, если заявлен | TODO | TODO | TODO |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
Эксперименты и отказы
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. Эксперименты проведены при одинаковых лимитах: 2CPU/2GiB. Тест 1: Stale Read при Logout
- Результат: PASS — токен корректно отклоняется после logout (401 Unauthorized)
- Механизм:
invalidate_session(token_hash)удаляет ключ из Redis при logout
Тест 2: Cache Stampede (100 параллельных запросов после истечения TTL)
- Время выполнения: 1.58 секунды
- Успешных аутентификаций: 100/100 (0 ошибок)
- Статистика SQL (pg_stat_statements):
SELECT FROM sessions WHERE token_hash = $1: 210 вызовов, 0.07 мс в среднемINSERT INTO sessions: 203 вызова, 1.00 мс в среднемDELETE FROM sessions: 2 вызова, 1.27 мс в среднем
- Вывод: Connection pool PostgreSQL (10 соединений) корректно распределил нагрузку.
Средняя latency проверки токена 0.07 мс доказывает эффективность индекса по
token_hash. Тест 3: Восстановление после рестарта Redis (Graceful Degradation) - Redis DOWN: Fallback на PostgreSQL → 200 OK (0 потерянных запросов)
- Redis UP: Кэш автоматически заполняется при следующих запросах
- Результат: PASS — полная функциональность при недоступности кэша
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
| TODO | TODO | TODO | TODO |
| Прогон тестов через scripts/cache_consistency_test.py | Успешное выполнение тестов 1-3 | Результат сохранён в results/cache_consistency.log | Потери запросов и данных нет |
Ограничения и следующие шаги
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. Asyncio lock работает только в рамках одного процесса. При горизонтальном масштабировании (несколько инстансов API) нужен распределённый lock (Redis Redlock или PostgreSQL advisory locks). Джиттер TTL — эвристический. 10% джиттер снижает вероятность stampede, но не устраняет его полностью. Более надёжное решение — probabilistic early expiration (проверка TTL и обновление с вероятностью 1 - (remaining_ttl / total_ttl)). Не измерена деградация при длительном отказе Redis. Если Redis недоступен >5 минут, все запросы идут в БД, что может привести к исчерпанию connection pool. Нужен circuit breaker. Тест cache stampede синтетический. В реальности TTL сессий разный (зависит от времени логина), поэтому массовое истечение маловероятно. Более реалистичный сценарий — резкий рост трафика после восстановления Redis.