feat-(report ready)

This commit is contained in:
2026-11-07 13:25:04 +03:00
parent 521e197595
commit 7dcef08d8b
2 changed files with 9 additions and 7 deletions
+6 -5
View File
@@ -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)
- [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [+] Контракт и публичные тесты не ослаблены.
+3 -2
View File
@@ -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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.