ЛР 2 — БВТ2304 — Савельев — на 5 #81

Closed
Savelev_Ivan wants to merge 2 commits from Savelev_Ivan/mtusi2026lab2:solution/bvt2304-savelev into master
First-time contributor

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

Автор / группа: Савельев Иван / БВТ2304
Целевая оценка (3/4/5): 5
Трек 5: 2 — «План запроса и восстановление»

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

  • Из lab1 перенесены REST API мессенджера, валидация, единый формат ошибок, X-Request-Id, проверки доступа, пагинация, Docker и собственные тесты.
  • Данные перенесены в PostgreSQL. Добавлены миграции, PK/FK/UNIQUE, атомарное создание чата с rollback, параметризованные SQL-запросы, ограниченный пул соединений и таймауты.
  • Реализованы регистрация с Argon2id, Basic-вход, Bearer-сессии, expiry и logout. Сессии хранятся в Valkey с TTL, AOF appendfsync always и постоянным volume. X-User-Id доступа не предоставляет.
  • Compose запускает API, PostgreSQL и Valkey. Скрипты автоматизируют создание локальных secrets, запуск, миграции, проверки и перезапуск всех сервисов с сохранением volumes.
  • Для трека 5 исследованы 100 000 сообщений в чатах размером 70 000 / 20 000 / 9 000 / 1 000. Сравнены два индекса в трёх повторах: чтение страниц, планы EXPLAIN (ANALYZE, BUFFERS), стоимость записи, размер индекса и WAL. Выполнены backup и восстановление в отдельный PostgreSQL с новым volume.

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

Нужны Docker Compose v2, Python 3.11, Bash, make, curl и jq. Из корня репозитория:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

./scripts/start.sh
./scripts/check.sh
make test-persistence PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/restart.sh

./scripts/check-docker.sh
./scripts/research.sh

.env и локальные secrets создаются автоматически. API доступно на http://localhost:8080. Остановка с сохранением данных: ./scripts/stop.sh.

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

Публичные smoke и persistence, 23 собственных теста прошли. Проверены:

  • 100 сообщений от 10 клиентов без потерь и дублей;
  • конкурентная регистрация одинакового username;
  • rollback создания чата и повторное применение миграций;
  • сохранение данных и прежнего токена после рестарта всех сервисов;
  • короткий TTL, logout, неверный пароль и отказы PostgreSQL/Valkey;
  • non-root, healthcheck, отсутствие чувствительных данных в логах и SIGTERM менее 10 секунд.

В исследовании медиана SQL-чтения страницы составила 1,685 мс → 0,226 мс. После восстановления совпали счётчики таблиц, 12 выбранных сообщений и SHA-256 всей истории. Отдельно показано отсутствие записи, сделанной после backup.

Методика и ограничения: [REPORT.md](https://gitea.privcloud.tech/Savelev_Ivan/mtusi2026lab2/src/branch/solution/bvt2304-savelev/REPORT.md). Реальный вывод и измерения находятся в evidence/docker-checks.txt, evidence/research.txt, evidence/research.json и evidence/query-plans.json.

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

Один host, одна API-реплика, PostgreSQL и Valkey без HA. Исследование выполнено последовательно на прогретых данных. SQL backup не включает сессии Valkey и записи после снимка. Время pg_restore измерено отдельно от полного восстановления сервиса. Успешный удалённый CI пока не заявлен.

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

Использованы официальные материалы PostgreSQL, Psycopg, Valkey, Argon2-cffi и OWASP; ссылки приведены в отчёте. Codex (OpenAI) помогал с реализацией, тестами, запуском проверок и документацией. Собственные тесты используют неизменённый HTTP-клиент преподавателя из tests/client.py.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Савельев Иван / БВТ2304 Целевая оценка (3/4/5): **5** Трек 5: **2 — «План запроса и восстановление»** **Что реализовано и что перенесено:** - Из lab1 перенесены REST API мессенджера, валидация, единый формат ошибок, `X-Request-Id`, проверки доступа, пагинация, Docker и собственные тесты. - Данные перенесены в PostgreSQL. Добавлены миграции, PK/FK/UNIQUE, атомарное создание чата с rollback, параметризованные SQL-запросы, ограниченный пул соединений и таймауты. - Реализованы регистрация с Argon2id, Basic-вход, Bearer-сессии, expiry и logout. Сессии хранятся в Valkey с TTL, AOF `appendfsync always` и постоянным volume. `X-User-Id` доступа не предоставляет. - Compose запускает API, PostgreSQL и Valkey. Скрипты автоматизируют создание локальных secrets, запуск, миграции, проверки и перезапуск всех сервисов с сохранением volumes. - Для трека 5 исследованы 100 000 сообщений в чатах размером 70 000 / 20 000 / 9 000 / 1 000. Сравнены два индекса в трёх повторах: чтение страниц, планы `EXPLAIN (ANALYZE, BUFFERS)`, стоимость записи, размер индекса и WAL. Выполнены backup и восстановление в отдельный PostgreSQL с новым volume. **Команды запуска из чистого clone:** Нужны Docker Compose v2, Python 3.11, Bash, make, curl и jq. Из корня репозитория: ```bash python3 -m venv .venv .venv/bin/python -m pip install -r requirements.txt ./scripts/start.sh ./scripts/check.sh make test-persistence PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/restart.sh ./scripts/check-docker.sh ./scripts/research.sh ``` `.env` и локальные secrets создаются автоматически. API доступно на `http://localhost:8080`. Остановка с сохранением данных: `./scripts/stop.sh`. **Результаты проверок и ссылка на REPORT.md:** Публичные smoke и persistence, 23 собственных теста прошли. Проверены: - 100 сообщений от 10 клиентов без потерь и дублей; - конкурентная регистрация одинакового username; - rollback создания чата и повторное применение миграций; - сохранение данных и прежнего токена после рестарта всех сервисов; - короткий TTL, logout, неверный пароль и отказы PostgreSQL/Valkey; - non-root, healthcheck, отсутствие чувствительных данных в логах и SIGTERM менее 10 секунд. В исследовании медиана SQL-чтения страницы составила **1,685 мс → 0,226 мс**. После восстановления совпали счётчики таблиц, 12 выбранных сообщений и SHA-256 всей истории. Отдельно показано отсутствие записи, сделанной после backup. Методика и ограничения: [[REPORT.md](https://gitea.privcloud.tech/Savelev_Ivan/mtusi2026lab2/src/branch/solution/bvt2304-savelev/REPORT.md)](https://gitea.privcloud.tech/Savelev_Ivan/mtusi2026lab2/src/branch/solution/bvt2304-savelev/REPORT.md). Реальный вывод и измерения находятся в `evidence/docker-checks.txt`, `evidence/research.txt`, `evidence/research.json` и `evidence/query-plans.json`. **Ограничения / известные ошибки:** Один host, одна API-реплика, PostgreSQL и Valkey без HA. Исследование выполнено последовательно на прогретых данных. SQL backup не включает сессии Valkey и записи после снимка. Время `pg_restore` измерено отдельно от полного восстановления сервиса. Успешный удалённый CI пока не заявлен. **Источники и использование ИИ:** Использованы официальные материалы PostgreSQL, Psycopg, Valkey, Argon2-cffi и OWASP; ссылки приведены в отчёте. Codex (OpenAI) помогал с реализацией, тестами, запуском проверок и документацией. Собственные тесты используют неизменённый HTTP-клиент преподавателя из `tests/client.py`. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Savelev_Ivan added 2 commits 2026-10-22 17:35:52 +03:00
реализация второй лабы
Application / docker (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
0dfbfe35f8
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:15 +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#81