ЛР2 – БПИ2303 – Поликарпов – На 5 #155

Closed
Grbisba wants to merge 5 commits from Grbisba/mtusi2026lab2:solution/bpi2303-polikarpov into master
First-time contributor

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

Автор / группа: Поликарпов Даниил Александрович, БПИ2303.
Целевая оценка: 5.
Трек 5: согласованность кэша — воспроизведение cache stampede, защита singleflight и сравнение SQL-нагрузки и задержек.

Что реализовано и что перенесено

  • Пользователи, чаты, участники, сообщения и сессии перенесены в PostgreSQL. Добавлены миграции Tern, ограничения целостности и транзакционное создание чата.
  • Идентификация через X-User-Id заменена Basic при входе и Bearer-сессиями. Пароли хэшируются Argon2id; реализованы expiry через SESSION_TTL_SECONDS и logout.
  • История использует keyset-пагинацию и индекс (chat_id, created_at, id).
  • Redis используется как необязательный кэш чатов с проверкой членства и переходом к PostgreSQL при отказе.
  • Singleflight подавляет повторные загрузки одного чата одним пользователем внутри API-процесса.
  • Настроены лимит пула PostgreSQL, таймауты, readiness с проверкой БД и ответы 503 при её недоступности.

Команды запуска из чистого clone

git clone https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2.git
cd mtusi2026lab2
git switch solution/bpi2303-polikarpov
cp .env.example .env

В .env задать собственные пароли PostgreSQL и Redis. Затем:

umask 077
make key-gen
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 120
curl --fail http://127.0.0.1:8080/health/ready

Настройка доступа UID 65532 к ключам на Linux и остальные подробности запуска приведены в REPORT.md.

Результаты проверок и ссылка на REPORT.md

Пройдены 16 из 16 групп проверок уровней «3» и «4»:

  • make check, make test и make test-persistence завершились с кодом 0.
  • Полный рестарт API, PostgreSQL и Redis сохранил данные и действующую сессию.
  • Гонка восьми регистраций дала один 201, семь 409 и одну строку пользователя.
  • Проверен rollback создания чата при ошибке FK участников.
  • На истории из 20 001 сообщения EXPLAIN подтвердил использование индекса; обход API не дал пропусков и дублей.
  • Проверены expiry, logout, неверный пароль, подделка JWT, отказы Redis/PostgreSQL и ограничение времени SQL.

Методика и результаты, реальный вывод команд, полный отчёт.

В эксперименте cache stampede число SELECT чата сократилось с 308 до 10 — на 96,75%. p95 холодных запросов изменился с 215,502 до 209,568 мс. Эти замеры относятся к предшествующей сборке, идентифицированной в отчёте эксперимента.

Ограничения / известные ошибки

Singleflight действует внутри одного процесса для пары «чат + пользователь». Кэш не имеет TTL и инвалидации; при добавлении изменения членства потребуется отдельная политика согласованности. Проверки выполнены на одной API-реплике. HA, аварийная потеря диска, сетевой blackhole и backup → restore не исследовались. Локальный стенд использует HTTP.

Источники и использование ИИ

Использованы материалы лабораторной и документация singleflight, PostgreSQL и go-redis. ChatGPT/Codex помогал с доработками приложения, сценариями проверки, экспериментами и подготовкой отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 **Автор / группа:** Поликарпов Даниил Александрович, БПИ2303. **Целевая оценка:** 5. **Трек 5:** согласованность кэша — воспроизведение cache stampede, защита singleflight и сравнение SQL-нагрузки и задержек. **Что реализовано и что перенесено** - Пользователи, чаты, участники, сообщения и сессии перенесены в PostgreSQL. Добавлены миграции Tern, ограничения целостности и транзакционное создание чата. - Идентификация через `X-User-Id` заменена Basic при входе и Bearer-сессиями. Пароли хэшируются Argon2id; реализованы expiry через `SESSION_TTL_SECONDS` и logout. - История использует keyset-пагинацию и индекс `(chat_id, created_at, id)`. - Redis используется как необязательный кэш чатов с проверкой членства и переходом к PostgreSQL при отказе. - Singleflight подавляет повторные загрузки одного чата одним пользователем внутри API-процесса. - Настроены лимит пула PostgreSQL, таймауты, readiness с проверкой БД и ответы 503 при её недоступности. **Команды запуска из чистого clone** ```sh git clone https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2.git cd mtusi2026lab2 git switch solution/bpi2303-polikarpov cp .env.example .env ``` В `.env` задать собственные пароли PostgreSQL и Redis. Затем: ```sh umask 077 make key-gen docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait --wait-timeout 120 curl --fail http://127.0.0.1:8080/health/ready ``` Настройка доступа UID 65532 к ключам на Linux и остальные подробности запуска приведены в [REPORT.md](REPORT.md). **Результаты проверок и ссылка на REPORT.md** Пройдены **16 из 16 групп проверок уровней «3» и «4»**: - `make check`, `make test` и `make test-persistence` завершились с кодом 0. - Полный рестарт API, PostgreSQL и Redis сохранил данные и действующую сессию. - Гонка восьми регистраций дала один 201, семь 409 и одну строку пользователя. - Проверен rollback создания чата при ошибке FK участников. - На истории из 20 001 сообщения EXPLAIN подтвердил использование индекса; обход API не дал пропусков и дублей. - Проверены expiry, logout, неверный пароль, подделка JWT, отказы Redis/PostgreSQL и ограничение времени SQL. [Методика и результаты](evidence/levels-3-4/README.md), [реальный вывод команд](evidence/levels-3-4/checks.txt), [полный отчёт](REPORT.md). В эксперименте cache stampede число SELECT чата сократилось **с 308 до 10 — на 96,75%**. p95 холодных запросов изменился с 215,502 до 209,568 мс. Эти замеры относятся к предшествующей сборке, идентифицированной в [отчёте эксперимента](evidence/cache-stampede/README.md). **Ограничения / известные ошибки** Singleflight действует внутри одного процесса для пары «чат + пользователь». Кэш не имеет TTL и инвалидации; при добавлении изменения членства потребуется отдельная политика согласованности. Проверки выполнены на одной API-реплике. HA, аварийная потеря диска, сетевой blackhole и backup → restore не исследовались. Локальный стенд использует HTTP. **Источники и использование ИИ** Использованы материалы лабораторной и документация [singleflight](https://pkg.go.dev/golang.org/x/sync@v0.23.0/singleflight), [PostgreSQL](https://www.postgresql.org/docs/17/pgstatstatements.html) и [go-redis](https://redis.io/docs/latest/develop/clients/go/produsage/). ChatGPT/Codex помогал с доработками приложения, сценариями проверки, экспериментами и подготовкой отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Grbisba added 4 commits 2026-11-06 14:00:54 +03:00
Grbisba added 1 commit 2026-11-06 14:17:26 +03:00
Вернул потерянный infra/README.md
Skeleton contracts / contracts (pull_request) Canceled after 0s
4e67ba0306
Grbisba changed title from ЛР2 – БПИ2303 – Поликарпов – На 4 to ЛР2 – БПИ2303 – Поликарпов – На 5 2026-11-06 14:17:58 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:16 +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#155