diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 6935616..7bbd74b 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,8 +1,8 @@ ## Лабораторная 2 Автор / группа: Синюк Максим / БПИ2301 -Целевая оценка (3/4/5): 5 -Трек 1 (на оценку 5): "Согласованность кэша" +Целевая оценка (3/4/5): 4 +Трек 1 (на оценку 5): "" Что реализовано и что перенесено: перенесены пользовательские тесты, валидация(перенастроена на пароль), роуты(перенастроены на защиту по токену сессии) Команды запуска из чистого clone: cd mtusi2026lab2 | docker compose -d --build | docker compose logs api --tail 50 @@ -10,9 +10,10 @@ Ограничения / известные ошибки: TODO Источники и использование ИИ: TODO -pool_size и pool_timeout защищают БД от исчерпания соединений (Connection Exhaustion) при DDoS или всплесках трафика, параметризованные запросы/безопасный ORM, Проверены гонка регистрации одинакового username(test_duplicate_username) и rollback составной операции. Кэш сессий хранится в Redis, он ускоряет проверку токена сложностью O(1) - cache hit, в случае cache miss/недоступности Redis запрос идёт в БД, а затем кэшируется(Redis is recovered). Источник истины — PostgreSQL(таблица sessions.Политика expiry: TTL = SESSION_TTL_SECONDS (совпадает с БД). -Инвалидация: при logout ключ удаляется; при истечении TTL — автоматически. -Источник истины БД. Так Race condition на создание уже существующего username защищено в миграции CONSTRAINT users_username_unique. Обоснование индекса messages_chat_created_id_idx путём генерации 10 000 сообщений и выполнения EXPLAIN (ANALYZE, BUFFERS) +pool_size и pool_timeout защищают БД от исчерпания соединений (Connection Exhaustion) при DDoS или всплесках трафика, параметризованные запросы/безопасный ORM, Проверены гонка регистрации одинакового username(test_duplicate_username) и rollback составной операции. Кэш сессий хранится в Redis, он ускоряет проверку токена сложностью O(1) - cache hit, в случае cache miss/недоступности Redis запрос идёт в БД, а затем кэшируется(Redis is recovered). Источник истины — PostgreSQL таблица sessions.Политика expiry: TTL = SESSION_TTL_SECONDS (совпадает с БД). +Инвалидация: при logout ключ удаляется; при истечении TTL — автоматически. TTL задаётся в переменных окружения .env +Источник истины БД. Так Race condition на создание уже существующего username защищено в миграции CONSTRAINT users_username_unique. Обоснование индекса messages_chat_created_id_idx в БД путём генерации 10 000 сообщений и выполнения EXPLAIN (ANALYZE, BUFFERS) в results/explain_comparison.txt +При недоступности кэша происходит его обход и обращение в БД. Ограниченная ошибка при его недоступности обрабатывается через в декораторе @application.exception_handler к функции def db_unavailable_handler(OperationalError) - [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [+] Контракт и публичные тесты не ослаблены. diff --git a/REPORT.md b/REPORT.md index 892d94a..5a76791 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,7 +1,7 @@ # Отчёт — лабораторная 2 - Автор, группа: Синюк Максим Павлович, БПИ2301 -- Целевая оценка; выбранный трек 5, если нужен: 5, трек 1 +- Целевая оценка; выбранный трек 5, если нужен: 4 - Commit/PR: TODO после публикации - Использованные источники, библиотеки и помощь ИИ: перенос базы лаб1, python, fastapi, uvicorn, pydantic, pytest, sqlalchemy, argon2-cffi, redis @@ -36,7 +36,7 @@ TODO: схема процессов/хранилищ, источник исти | Проверка нагрузки | 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 требует подтверждения, какие реальные процессы/хранилища перезапущены. @@ -52,3 +52,4 @@ TODO: гипотеза, hardware/лимиты, версии, объём данн ## Ограничения и следующие шаги TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +