ЛР 2 — БВТ2301 — Койчакаев — на 5 #139

Closed
koichakaev wants to merge 2 commits from koichakaev/mtusi2026lab2:solution/bvt2301-koichakaev into master
First-time contributor

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

Автор / группа: Койчакаев Багавдин / БВТ2301
Целевая оценка (3/4/5): 5
Трек 5: 2 — план запроса и восстановление.

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

Сохранены API пользователей, чатов и сообщений, проверки входных данных и членства, пагинация и health endpoints из собственной lab1. Состояние перенесено в PostgreSQL с версионируемой миграцией, ограничениями и транзакциями. Аутентификация переведена с X-User-Id на Basic-вход и opaque Bearer-сессии: Argon2id, срок жизни и logout. PostgreSQL хранит действующие сессии; Valkey используется как TTL-кэш с обходом при отказе. Добавлены ограниченный пул соединений, таймауты, keyset-пагинация, Docker Compose с именованными volumes и собственные проверки в student-tests/.

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

git clone --branch solution/bvt2301-koichakaev https://gitea.privcloud.tech/koichakaev/mtusi2026lab2.git
cd mtusi2026lab2
cp .env.example .env
# Заменить POSTGRES_PASSWORD в .env на локальный пароль.
docker compose --env-file .env up -d --build --wait --wait-timeout 180
make check
make test BASE_URL=http://127.0.0.1:8080
make track2
make quality BASE_URL=http://127.0.0.1:8080
make test-dependencies BASE_URL=http://127.0.0.1:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080

Проверка expiry: временно установить SESSION_TTL_SECONDS=2 в .env, пересоздать API командой docker compose --env-file .env up -d --force-recreate --wait api и выполнить make test-ttl BASE_URL=http://127.0.0.1:8080; затем вернуть TTL=3600 и снова пересоздать API.

Результаты проверок

make check, публичный make test, make quality, make test-dependencies, make test-persistence, make test-ttl при TTL=2 и make track2 — PASS на локальном Docker Desktop.

Гонка регистрации: ровно 1×201 и 11×409; невалидное создание чата не оставляет строку. Данные и прежний токен пережили полный рестарт API/PostgreSQL/Valkey. При отказе Valkey работает PostgreSQL; при отказе PostgreSQL возвращается ограниченная 503, после восстановления прежняя сессия работает.

Трек 2: 100 000 синтетических сообщений с распределением 80 000 в одном чате и 20 000 в 200 малых чатах; сравнение двух индексов и трёх парных вставок по 10 000 строк. Backup восстановлен в отдельный PostgreSQL с собственным volume. Совпали количества строк во всех пяти таблицах и выбранные сообщения; финальный backup — 0,556 s, restore — 0,608 s.

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

Стенд предназначен для локальной работы по HTTP на loopback. Репликация и failover не заявлены. Восстановление проверено на том же Docker Desktop host; 0,608 s — время pg_restore, а не полный аварийный RTO. Изменения после снимка pg_dump не входят в backup; WAL/PITR не настроены. Плановые timings единичные, записи измерены в трёх парных повторах. Добавлен application job для GitHub Actions; успешный запуск CI на Gitea не заявляется, приложены локальные результаты.

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

Контракт и материалы курса, собственная lab1; Python 3.12.8, PostgreSQL 16.4, Valkey 8.0.1, psycopg, argon2-cffi и redis-py. При подготовке реализации, проверок и отчёта использовался Codex.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: **Койчакаев Багавдин / БВТ2301** Целевая оценка (3/4/5): **5** Трек 5: **2 — план запроса и восстановление**. ### Что реализовано и что перенесено Сохранены API пользователей, чатов и сообщений, проверки входных данных и членства, пагинация и health endpoints из собственной lab1. Состояние перенесено в PostgreSQL с версионируемой миграцией, ограничениями и транзакциями. Аутентификация переведена с X-User-Id на Basic-вход и opaque Bearer-сессии: Argon2id, срок жизни и logout. PostgreSQL хранит действующие сессии; Valkey используется как TTL-кэш с обходом при отказе. Добавлены ограниченный пул соединений, таймауты, keyset-пагинация, Docker Compose с именованными volumes и собственные проверки в `student-tests/`. ### Команды запуска из чистого clone ```sh git clone --branch solution/bvt2301-koichakaev https://gitea.privcloud.tech/koichakaev/mtusi2026lab2.git cd mtusi2026lab2 cp .env.example .env # Заменить POSTGRES_PASSWORD в .env на локальный пароль. docker compose --env-file .env up -d --build --wait --wait-timeout 180 make check make test BASE_URL=http://127.0.0.1:8080 make track2 make quality BASE_URL=http://127.0.0.1:8080 make test-dependencies BASE_URL=http://127.0.0.1:8080 make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080 ``` Проверка expiry: временно установить `SESSION_TTL_SECONDS=2` в `.env`, пересоздать API командой `docker compose --env-file .env up -d --force-recreate --wait api` и выполнить `make test-ttl BASE_URL=http://127.0.0.1:8080`; затем вернуть TTL=3600 и снова пересоздать API. ### Результаты проверок `make check`, публичный `make test`, `make quality`, `make test-dependencies`, `make test-persistence`, `make test-ttl` при TTL=2 и `make track2` — **PASS** на локальном Docker Desktop. Гонка регистрации: ровно 1×201 и 11×409; невалидное создание чата не оставляет строку. Данные и прежний токен пережили полный рестарт API/PostgreSQL/Valkey. При отказе Valkey работает PostgreSQL; при отказе PostgreSQL возвращается ограниченная 503, после восстановления прежняя сессия работает. Трек 2: 100 000 синтетических сообщений с распределением 80 000 в одном чате и 20 000 в 200 малых чатах; сравнение двух индексов и трёх парных вставок по 10 000 строк. Backup восстановлен в отдельный PostgreSQL с собственным volume. Совпали количества строк во всех пяти таблицах и выбранные сообщения; финальный backup — 0,556 s, restore — 0,608 s. - [REPORT.md: методика, результаты и ограничения](https://gitea.privcloud.tech/koichakaev/mtusi2026lab2/src/branch/solution/bvt2301-koichakaev/REPORT.md) - [Сводка полного прогона](https://gitea.privcloud.tech/koichakaev/mtusi2026lab2/src/branch/solution/bvt2301-koichakaev/evidence/lab2-run.txt) - [Фактический вывод финальных проверок](https://gitea.privcloud.tech/koichakaev/mtusi2026lab2/src/branch/solution/bvt2301-koichakaev/evidence/submission-checks.txt) - [Планы и исходные измерения трека 2](https://gitea.privcloud.tech/koichakaev/mtusi2026lab2/src/branch/solution/bvt2301-koichakaev/evidence/track2-results.json) ### Ограничения / известные ошибки Стенд предназначен для локальной работы по HTTP на loopback. Репликация и failover не заявлены. Восстановление проверено на том же Docker Desktop host; 0,608 s — время pg_restore, а не полный аварийный RTO. Изменения после снимка pg_dump не входят в backup; WAL/PITR не настроены. Плановые timings единичные, записи измерены в трёх парных повторах. Добавлен application job для GitHub Actions; успешный запуск CI на Gitea не заявляется, приложены локальные результаты. ### Источники и использование ИИ Контракт и материалы курса, собственная lab1; Python 3.12.8, PostgreSQL 16.4, Valkey 8.0.1, psycopg, argon2-cffi и redis-py. При подготовке реализации, проверок и отчёта использовался Codex. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
koichakaev added 1 commit 2026-10-30 21:08:04 +03:00
ЛР 2: PostgreSQL, сессии, Valkey и исследование восстановления
Skeleton contracts / contracts (pull_request) Canceled after 0s
Skeleton contracts / application (pull_request) Canceled after 0s
5b47c579cc
koichakaev added 1 commit 2026-10-30 21:09:12 +03:00
docs: добавить ссылки на PR и коммит решения
Skeleton contracts / contracts (pull_request) Canceled after 0s
Skeleton contracts / application (pull_request) Canceled after 0s
7bb0f4da26
Owner

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

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