ЛР 2 — БПИ2302 — Кушнаренко — на 5 #121

Open
kolya wants to merge 3 commits from kolya/mtusi2026lab2:solution/bpi2302-kushnarenko into master
First-time contributor

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

Автор / группа: Кушнаренко Николай Вячеславович, БПИ2302
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 2 — план запроса и восстановление

Что реализовано и что перенесено:
Перенесён HTTP-слой мессенджера из ЛР1 с объявленным переходом от X-User-Id к аутентификации Basic → Bearer. Пользователи, чаты, участники, сообщения и сессии хранятся в PostgreSQL. Добавлены миграции, ограничения и индексы БД, атомарное создание чата, хеширование паролей Argon2id, срок жизни и отзыв сессий. Valkey используется как кэш сессий; источник истины — PostgreSQL. Подготовлен Docker Compose со службами API, PostgreSQL, Valkey и миграций, именованными volumes и скриптом перезапуска. Добавлены собственные тесты API, срока жизни сессий и отказов зависимостей.

Для трека 2 исследованы планы запросов на 105 000 сообщениях с неравномерными размерами чатов: сравнены четыре варианта индексов, скорость чтения и стоимость записи. Выполнены backup, восстановление в новое хранилище и сверка данных.

Команды запуска из чистого clone:
sh scripts/init-secrets.sh
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
python3 tests/smoke.py --base-url http://127.0.0.1:8080
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080

На Windows для persistence-проверки используется scripts/restart.cmd. Подробная инструкция — в REPORT.md.

Результаты проверок и ссылка на REPORT.md:
REPORT.md; evidence/checks.txt, persistence_containers.txt, migrations.txt, track2_results.json и track2_explain_plans.txt.

  • публичный smoke — PASS;
  • persistence-проверка — PASS: после перезапуска API, PostgreSQL и Valkey прежняя сессия и подтверждённые данные сохранились;
  • миграция применена на пустой БД и повторно запускается без дублирования;
  • 12 собственных API-тестов — OK; тесты expiry и отказов PostgreSQL/Valkey — OK;
  • составной индекс истории даёт Index Scan для keyset-страницы: медиана 0,076 мс против 10,195 мс без индекса в исследованном сценарии;
  • после восстановления backup совпали количество и контрольные суммы сообщений, а также выборочная страница истории.

Ограничения / известные ошибки:
PostgreSQL работает в одном экземпляре: потеря его volume или хоста не покрывается автоматическим восстановлением. При недоступности Valkey во время logout возможно окно устаревания записи кэша до 60 секунд. Логический backup сохраняет состояние на момент создания; записи после него в восстановленной копии отсутствуют. Измерения выполнены на одном компьютере и не доказывают такие же абсолютные задержки на другом стенде. Подробнее — в REPORT.md.

Источники и использование ИИ:
Python 3.12, uvicorn, asyncpg, redis-py, argon2-cffi; документация PostgreSQL по EXPLAIN и pg_dump, документация Valkey. Codex использовался для помощи с написанием кода, выполнением части заданий и проверкой качества. Результаты подтверждены сохранёнными выводами запусков в evidence/.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • Проверки структуры, публичного API и persistence выполнены; вывод приложен в evidence/.
  • Сценарии отказов и безопасности своего уровня воспроизведены.
  • Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию запуска решения.
## Лабораторная 2 Автор / группа: Кушнаренко Николай Вячеславович, БПИ2302 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 2 — план запроса и восстановление Что реализовано и что перенесено: Перенесён HTTP-слой мессенджера из ЛР1 с объявленным переходом от X-User-Id к аутентификации Basic → Bearer. Пользователи, чаты, участники, сообщения и сессии хранятся в PostgreSQL. Добавлены миграции, ограничения и индексы БД, атомарное создание чата, хеширование паролей Argon2id, срок жизни и отзыв сессий. Valkey используется как кэш сессий; источник истины — PostgreSQL. Подготовлен Docker Compose со службами API, PostgreSQL, Valkey и миграций, именованными volumes и скриптом перезапуска. Добавлены собственные тесты API, срока жизни сессий и отказов зависимостей. Для трека 2 исследованы планы запросов на 105 000 сообщениях с неравномерными размерами чатов: сравнены четыре варианта индексов, скорость чтения и стоимость записи. Выполнены backup, восстановление в новое хранилище и сверка данных. Команды запуска из чистого clone: sh scripts/init-secrets.sh cp .env.example .env docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build python3 tests/smoke.py --base-url http://127.0.0.1:8080 python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080 На Windows для persistence-проверки используется scripts/restart.cmd. Подробная инструкция — в REPORT.md. Результаты проверок и ссылка на REPORT.md: REPORT.md; evidence/checks.txt, persistence_containers.txt, migrations.txt, track2_results.json и track2_explain_plans.txt. - публичный smoke — PASS; - persistence-проверка — PASS: после перезапуска API, PostgreSQL и Valkey прежняя сессия и подтверждённые данные сохранились; - миграция применена на пустой БД и повторно запускается без дублирования; - 12 собственных API-тестов — OK; тесты expiry и отказов PostgreSQL/Valkey — OK; - составной индекс истории даёт Index Scan для keyset-страницы: медиана 0,076 мс против 10,195 мс без индекса в исследованном сценарии; - после восстановления backup совпали количество и контрольные суммы сообщений, а также выборочная страница истории. Ограничения / известные ошибки: PostgreSQL работает в одном экземпляре: потеря его volume или хоста не покрывается автоматическим восстановлением. При недоступности Valkey во время logout возможно окно устаревания записи кэша до 60 секунд. Логический backup сохраняет состояние на момент создания; записи после него в восстановленной копии отсутствуют. Измерения выполнены на одном компьютере и не доказывают такие же абсолютные задержки на другом стенде. Подробнее — в REPORT.md. Источники и использование ИИ: Python 3.12, uvicorn, asyncpg, redis-py, argon2-cffi; документация PostgreSQL по EXPLAIN и pg_dump, документация Valkey. Codex использовался для помощи с написанием кода, выполнением части заданий и проверкой качества. Результаты подтверждены сохранёнными выводами запусков в evidence/. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] Проверки структуры, публичного API и persistence выполнены; вывод приложен в evidence/. - [x] Сценарии отказов и безопасности своего уровня воспроизведены. - [x] Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов. - [x] README задания сохранён, REPORT.md содержит инструкцию запуска решения.
kolya added 2 commits 2026-10-29 22:11:28 +03:00
kolya added 1 commit 2026-10-29 22:12:32 +03:00
ЛР2: добавить ссылку на PR в отчёт
Skeleton contracts / contracts (pull_request) Canceled after 0s
0d6aa8e052
Some required checks failed
1 workflow awaiting approval

The workflow will only run after approval from the repository maintainer.

Skeleton contracts / contracts (pull_request) Canceled after 0s
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/kolya/mtusi2026lab2 solution/bpi2302-kushnarenko:kolya-solution/bpi2302-kushnarenko
git checkout kolya-solution/bpi2302-kushnarenko
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#121