ЛР 2 — БВТ2301 — Гамаюнов — на 5 #97

Closed
gamayunov2004 wants to merge 5 commits from gamayunov2004/mtusi2026lab2:solution/bvt2301-gamayunov into master
First-time contributor

Лабораторная 2

Автор / группа: Гамаюнов Артём, БВТ2301
Целевая оценка: 5
Выбранный трек 5: Трек 1 — согласованность кэша (cache stampede).

Что реализовано и перенесено из ЛР1: REST API пользователей, чатов и сообщений с контролем доступа, обработкой ошибок и cursor pagination. Сохранена обязательная функциональность ЛР1, адаптированная к PostgreSQL. В ЛР2 реализованы миграции и транзакции, Argon2id, Basic для входа, Bearer-сессии с expiry/logout, Docker Compose, Valkey для кэширования публичных профилей с TTL 60 секунд, собственные негативные, конкурентные и отказные тесты. Исследовательский in-memory индекс ЛР1 здесь не используется: историю обрабатывает PostgreSQL с SQL-индексом и keyset pagination.

Исследование на «5»: воспроизведён cache stampede при параллельном чтении одного профиля. Добавлена ограниченная single-flight защита внутри API-процесса: при одновременном запросе профиля один запрос получает данные из PostgreSQL, остальные используют результат. Проверка Bearer-сессии через PostgreSQL сохранена на каждом защищённом запросе.

Методика: 16 клиентов, три режима (cold, contended, warm), по три повтора; до и после изменения применялись одинаковые HTTP-нагрузка и подсчёт SQL через pg_stat_statements. В основных сериях выполнено по 4608 успешных HTTP-запросов на каждую версию, без ошибок и таймаутов.

Результаты:

Метрика До После
SELECT профиля, все серии 2994 192
SELECT сессии, все серии 4608 4608
Все SQL-операции, включая транзакционные 22836 14418
Cold throughput, медиана 87,03 RPS 151,32 RPS
Cold p95, медиана 279,25 мс 167,42 мс
Cold p99, медиана 296,88 мс 205,41 мс

Число SELECT профиля сократилось примерно на 93,6% суммарно по сериям. Зафиксирована и отрицательная сторона изменения: в warm-режиме p99 вырос примерно на 5%, статистическая значимость не установлена.

Запуск из чистого clone (Linux):

sh scripts/init-env.sh
docker compose --profile test build
docker compose --profile test up -d --wait api api-expiry
docker compose --profile test run --rm tools sh scripts/run-checks.sh

Для Windows подготовлен scripts/init-env.ps1. Подробная инструкция, проверенные команды, сырые измерения, график и повторяемая методика находятся в REPORT.md, evidence/, evidence/grade5/README.md и evidence/grade5/.

Проверки: локально пройдены make check, make validate, публичный make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh, сценарии уровня «4», пять unit-тестов single-flight и исследовательские тесты. Проверены миграции, конкурентность, expiry/logout, EXPLAIN на 10 000 сообщениях, отказ PostgreSQL/Valkey, потеря и восстановление кэша, доступ из двух API-процессов и read-after-write для сохраняемых в БД данных. Результаты и ограничения подтверждены сохранёнными evidence. Удалённый CI зависит от разрешения сопровождающего репозитория.

Ограничения: single-flight работает только в одном процессе; при нескольких API-репликах возможен отдельный SQL-запрос на реплику. После таймаута ожидания допускается fallback в PostgreSQL. Исследование проводилось на одном Docker-host с синтетической нагрузкой, без количественной оценки дополнительной стоимости CPU/RAM. Отдельная проверка HA и backup/restore не заявляется.

Источники и использование ИИ: задание, контракт и документация лабораторной, собственные реализации ЛР1 и ЛР2, документация PostgreSQL, Python, FastAPI, Valkey. ChatGPT/Codex использовались для проектирования, реализации, экспериментов, тестирования, независимого ревью и оформления отчёта.

  • Обязательные требования уровней «3» и «4» сохранены.
  • Преподавательский контракт и публичные тесты не ослаблены.
  • Выбранный исследовательский трек «5» выполнен, исходные измерения сохранены.
  • Публичные, собственные и отказные проверки выполнены локально.
  • Отчёт, методика воспроизведения и evidence приложены.
  • Секреты, токены и приватные ключи не включены в Git.
## Лабораторная 2 **Автор / группа:** Гамаюнов Артём, БВТ2301 **Целевая оценка:** 5 **Выбранный трек 5:** Трек 1 — согласованность кэша (cache stampede). **Что реализовано и перенесено из ЛР1:** REST API пользователей, чатов и сообщений с контролем доступа, обработкой ошибок и cursor pagination. Сохранена обязательная функциональность ЛР1, адаптированная к PostgreSQL. В ЛР2 реализованы миграции и транзакции, Argon2id, Basic для входа, Bearer-сессии с expiry/logout, Docker Compose, Valkey для кэширования публичных профилей с TTL 60 секунд, собственные негативные, конкурентные и отказные тесты. Исследовательский in-memory индекс ЛР1 здесь не используется: историю обрабатывает PostgreSQL с SQL-индексом и keyset pagination. **Исследование на «5»:** воспроизведён cache stampede при параллельном чтении одного профиля. Добавлена ограниченная single-flight защита внутри API-процесса: при одновременном запросе профиля один запрос получает данные из PostgreSQL, остальные используют результат. Проверка Bearer-сессии через PostgreSQL сохранена на каждом защищённом запросе. **Методика:** 16 клиентов, три режима (cold, contended, warm), по три повтора; до и после изменения применялись одинаковые HTTP-нагрузка и подсчёт SQL через `pg_stat_statements`. В основных сериях выполнено по 4608 успешных HTTP-запросов на каждую версию, без ошибок и таймаутов. **Результаты:** | Метрика | До | После | |---|---:|---:| | SELECT профиля, все серии | 2994 | 192 | | SELECT сессии, все серии | 4608 | 4608 | | Все SQL-операции, включая транзакционные | 22836 | 14418 | | Cold throughput, медиана | 87,03 RPS | 151,32 RPS | | Cold p95, медиана | 279,25 мс | 167,42 мс | | Cold p99, медиана | 296,88 мс | 205,41 мс | Число SELECT профиля сократилось примерно на 93,6% суммарно по сериям. Зафиксирована и отрицательная сторона изменения: в warm-режиме p99 вырос примерно на 5%, статистическая значимость не установлена. **Запуск из чистого clone (Linux):** ```bash sh scripts/init-env.sh docker compose --profile test build docker compose --profile test up -d --wait api api-expiry docker compose --profile test run --rm tools sh scripts/run-checks.sh ``` Для Windows подготовлен `scripts/init-env.ps1`. Подробная инструкция, проверенные команды, сырые измерения, график и повторяемая методика находятся в `REPORT.md`, `evidence/`, `evidence/grade5/README.md` и `evidence/grade5/`. **Проверки:** локально пройдены `make check`, `make validate`, публичный `make test`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh`, сценарии уровня «4», пять unit-тестов single-flight и исследовательские тесты. Проверены миграции, конкурентность, expiry/logout, EXPLAIN на 10 000 сообщениях, отказ PostgreSQL/Valkey, потеря и восстановление кэша, доступ из двух API-процессов и read-after-write для сохраняемых в БД данных. Результаты и ограничения подтверждены сохранёнными evidence. Удалённый CI зависит от разрешения сопровождающего репозитория. **Ограничения:** single-flight работает только в одном процессе; при нескольких API-репликах возможен отдельный SQL-запрос на реплику. После таймаута ожидания допускается fallback в PostgreSQL. Исследование проводилось на одном Docker-host с синтетической нагрузкой, без количественной оценки дополнительной стоимости CPU/RAM. Отдельная проверка HA и backup/restore не заявляется. **Источники и использование ИИ:** задание, контракт и документация лабораторной, собственные реализации ЛР1 и ЛР2, документация PostgreSQL, Python, FastAPI, Valkey. ChatGPT/Codex использовались для проектирования, реализации, экспериментов, тестирования, независимого ревью и оформления отчёта. - [x] Обязательные требования уровней «3» и «4» сохранены. - [x] Преподавательский контракт и публичные тесты не ослаблены. - [x] Выбранный исследовательский трек «5» выполнен, исходные измерения сохранены. - [x] Публичные, собственные и отказные проверки выполнены локально. - [x] Отчёт, методика воспроизведения и evidence приложены. - [x] Секреты, токены и приватные ключи не включены в Git.
gamayunov2004 added 1 commit 2026-10-23 18:26:36 +03:00
ЛР 2: PostgreSQL, сессии и Valkey — на 4
Student application / application (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
18b419cda2
gamayunov2004 added 1 commit 2026-10-23 18:34:11 +03:00
Add PR link and update publication status
Student application / application (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
7db5f68fd6
gamayunov2004 added 1 commit 2026-10-23 18:44:15 +03:00
Remove obsolete PR draft
Student application / application (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
b5b35682c2
gamayunov2004 added 1 commit 2026-10-25 15:42:35 +03:00
ЛР 2: исследовать и ограничить cache stampede — на 5
Student application / application (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
799f56c513
gamayunov2004 changed title from ЛР 2 — БВТ2301 — Гамаюнов — на 4 to ЛР 2 — БВТ2301 — Гамаюнов — на 5 2026-10-25 15:43:53 +03:00
gamayunov2004 added 1 commit 2026-10-25 16:03:03 +03:00
Update grade 5 report publication status
Student application / application (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
207e380916
Author
First-time contributor

прошу зачесть на 3, остальные лабы сразу на 3 буду делать

прошу зачесть на 3, остальные лабы сразу на 3 буду делать
Owner

Принято на 3

Принято на 3
veprickiy closed this pull request 2026-11-20 22:06:45 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#97