ЛР 2 - БВТ2303 - Голиков - на 5 #10

Closed
Maximillan_Mercer wants to merge 61 commits from Maximillan_Mercer/mtusi2026lab2_fork:solution/BVT2303-Golikov into master
First-time contributor

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

Автор / группа: Голиков Антон / БВТ2303
Целевая оценка: 5
Трек 5: трек 2 “План запроса и восстановление”

Что изменилось с прошлой лабы

В lab1 всё было в памяти и за пользователя можно было выдать себя через X-User-Id. Теперь так не работает.

  • Состояние переехало в PostgreSQL 16. Таблицы users, chats, chat_members, messages, sessions через миграции goose (//go:embed). PK/FK/UNIQUE/CHECK прямо в схеме. Данные и активные сессии переживают перезапуск API и всех хранилищ.
  • Регистрация требует password. Хеш Argon2id (m=64 MiB, t=3, p=4), в БД PHC-строка, сравнение через subtle.ConstantTimeCompare.
  • Basic принимается только на POST /auth/sessions. Возвращает opaque Bearer: 32 случайных байта base64url, в хранилище только SHA-256. Все защищённые endpoint требуют Bearer, X-User-Id игнорируется.
  • Сессии в Redis 7.4 (SESSION_STORE=redis) с AOF everysec. Есть альтернативный репозиторий на Postgres через тот же интерфейс domain.SessionRepository. Переключается переменной без правок кода.
  • Keyset-пагинация (created_at, id) ASC. Курсор привязан к ресурсу через scope, чужой курсор из другого чата даёт 400.
  • Создание чата атомарно: INSERT chats + INSERT chat_members в одной транзакции, defer tx.Rollback.
  • X-Request-Id на всех ответах, WWW-Authenticate: Bearer только на 401.
  • Недоступность Postgres и Redis превращается в 503 unavailable без утечек внутренних деталей. BearerAuth оборачивает Resolve в context.WithTimeout(3s), Redis-клиент с таймаутами 700 ms, pgxpool HealthCheckPeriod=10s.
  • /health/ready реально пингует зависимости, а не возвращает 200 всегда.
    Трек 2

Исследование на 100 000 сообщений в 24 чатах с неравномерным распределением (1×55k, 3×10k, 10×1k, 10×500). Сравнил 4 конфигурации индексов, замерил стоимость записи, сделал pg_dump, восстановил в отдельный контейнер, сверил счётчики и md5 первых 1000 сообщений.

Короткий вывод:

  • baseline (chat_id, created_at, id) реально используется планировщиком, 45 буферов, 0.070 ms;

  • полностью покрывающий INCLUDE (sender_id, text) даёт Index Only Scan с Heap Fetches=0 и 4 буфера, это 11x меньше I/O;

  • частичное покрытие INCLUDE (sender_id) не помогает, план остаётся Index Scan, потому что запрос выбирает колонку text;

  • без индекса Seq Scan в 138 раз медленнее (9.660 ms, 1486 буферов);

  • backup/restore проходит со сверкой счётчиков и md5.
    Команды запуска из чистого clone

    mkdir -p secrets
    PGPASS=$(openssl rand -base64 24)
    printf '%s' "$PGPASS" > secrets/postgres_password
    printf '%s://%s:%s@%s:5432/%s?sslmode=disable' postgres messenger "$PGPASS" postgres messenger > secrets/database_url
    printf '%s' 'redis://redis:6379/0' > secrets/cache_url
    chmod 600 secrets/*
    cp .env.example .env
    docker compose --env-file .env up -d --build
    until curl -fs http://localhost:8080/health/ready >/dev/null; do sleep 1; done
    make check
    python tests/smoke.py
    python student-tests/run_all.py
    python student-tests/test_resilience.py --service postgres
    python student-tests/test_resilience.py --service redis
    python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh

Persistence-тест только из WSL: tests/resilience.py вызывает .sh напрямую через subprocess, на Windows падает с WinError 193.

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

  • python tests/smoke.py - PASS
  • python student-tests/run_all.py - 3 из 3 PASS
  • test_resilience.py –service postgres - PASS, 503 unavailable без утечек
  • test_resilience.py –service redis - PASS, 503 unavailable без утечек
  • tests/resilience.py –mode persistence (WSL) - PASS, сессия и данные живы
  • test_expiry.py при SESSION_TTL_SECONDS=2 - PASS, 401 Bearer после TTL

Артефакты трека 2 в evidence/:

  • explain_history_10k.txt и explain_history.txt
  • index_comparison.txt (A/B1/B2/C)
  • write_cost.txt (5000 INSERT, размеры индексов)
  • backup_restore.txt (PASS счётчиков и md5)
  • seed_large.txt и chat_ids.txt

Полные цифры и методика в REPORT.md, раздел “Трек 5”.

Ограничения

  • Один Docker-host, отказоустойчивость к потере узла не проверял.
  • Один процесс API, балансировщик будет в lab3.
  • pg_dump без WAL-архивации, RPO = времени последнего дампа.
  • write_bench один замер, разница 288 vs 353 ms на 5000 INSERT это шум WSL 2, не воспроизводимый результат.
  • Тестовые сообщения короткие, B2 по text на реальных 1000-символьных текстах дал бы больше.

Источники и ИИ

Документация PostgreSQL 16 (EXPLAIN, pg_dump, pg_indexes, pg_stat_user_indexes), pgx/v5, gin, go-redis v9, goose, RFC 9106. Материалы курса: contracts/openapi.json, contracts/README.md, tests/README.md.

ChatGPT помогал сформулировать собственные тесты в student-tests/ и оформить отчёт по фактически полученным результатам. Архитектуру, код сервера и финальные тексты проверял и правил вручную.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Голиков Антон / БВТ2303 Целевая оценка: 5 Трек 5: трек 2 “План запроса и восстановление” Что изменилось с прошлой лабы В lab1 всё было в памяти и за пользователя можно было выдать себя через X-User-Id. Теперь так не работает. - Состояние переехало в PostgreSQL 16. Таблицы users, chats, chat_members, messages, sessions через миграции goose (//go:embed). PK/FK/UNIQUE/CHECK прямо в схеме. Данные и активные сессии переживают перезапуск API и всех хранилищ. - Регистрация требует password. Хеш Argon2id (m=64 MiB, t=3, p=4), в БД PHC-строка, сравнение через subtle.ConstantTimeCompare. - Basic принимается только на POST /auth/sessions. Возвращает opaque Bearer: 32 случайных байта base64url, в хранилище только SHA-256. Все защищённые endpoint требуют Bearer, X-User-Id игнорируется. - Сессии в Redis 7.4 (SESSION_STORE=redis) с AOF everysec. Есть альтернативный репозиторий на Postgres через тот же интерфейс domain.SessionRepository. Переключается переменной без правок кода. - Keyset-пагинация (created_at, id) ASC. Курсор привязан к ресурсу через scope, чужой курсор из другого чата даёт 400. - Создание чата атомарно: INSERT chats + INSERT chat_members в одной транзакции, defer tx.Rollback. - X-Request-Id на всех ответах, WWW-Authenticate: Bearer только на 401. - Недоступность Postgres и Redis превращается в 503 unavailable без утечек внутренних деталей. BearerAuth оборачивает Resolve в context.WithTimeout(3s), Redis-клиент с таймаутами 700 ms, pgxpool HealthCheckPeriod=10s. - /health/ready реально пингует зависимости, а не возвращает 200 всегда. Трек 2 Исследование на 100 000 сообщений в 24 чатах с неравномерным распределением (1×55k, 3×10k, 10×1k, 10×500). Сравнил 4 конфигурации индексов, замерил стоимость записи, сделал pg_dump, восстановил в отдельный контейнер, сверил счётчики и md5 первых 1000 сообщений. Короткий вывод: - baseline (chat_id, created_at, id) реально используется планировщиком, 45 буферов, 0.070 ms; - полностью покрывающий INCLUDE (sender_id, text) даёт Index Only Scan с Heap Fetches=0 и 4 буфера, это 11x меньше I/O; - частичное покрытие INCLUDE (sender_id) не помогает, план остаётся Index Scan, потому что запрос выбирает колонку text; - без индекса Seq Scan в 138 раз медленнее (9.660 ms, 1486 буферов); - backup/restore проходит со сверкой счётчиков и md5. Команды запуска из чистого clone mkdir -p secrets PGPASS=$(openssl rand -base64 24) printf '%s' "$PGPASS" > secrets/postgres_password printf '%s://%s:%s@%s:5432/%s?sslmode=disable' postgres messenger "$PGPASS" postgres messenger > secrets/database_url printf '%s' 'redis://redis:6379/0' > secrets/cache_url chmod 600 secrets/* cp .env.example .env docker compose --env-file .env up -d --build until curl -fs http://localhost:8080/health/ready >/dev/null; do sleep 1; done make check python tests/smoke.py python student-tests/run_all.py python student-tests/test_resilience.py --service postgres python student-tests/test_resilience.py --service redis python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh Persistence-тест только из WSL: tests/resilience.py вызывает .sh напрямую через subprocess, на Windows падает с WinError 193. Результаты проверок - python tests/smoke.py - PASS - python student-tests/run_all.py - 3 из 3 PASS - test_resilience.py –service postgres - PASS, 503 unavailable без утечек - test_resilience.py –service redis - PASS, 503 unavailable без утечек - tests/resilience.py –mode persistence (WSL) - PASS, сессия и данные живы - test_expiry.py при SESSION_TTL_SECONDS=2 - PASS, 401 Bearer после TTL Артефакты трека 2 в evidence/: - explain_history_10k.txt и explain_history.txt - index_comparison.txt (A/B1/B2/C) - write_cost.txt (5000 INSERT, размеры индексов) - backup_restore.txt (PASS счётчиков и md5) - seed_large.txt и chat_ids.txt Полные цифры и методика в REPORT.md, раздел “Трек 5”. Ограничения - Один Docker-host, отказоустойчивость к потере узла не проверял. - Один процесс API, балансировщик будет в lab3. - pg_dump без WAL-архивации, RPO = времени последнего дампа. - write_bench один замер, разница 288 vs 353 ms на 5000 INSERT это шум WSL 2, не воспроизводимый результат. - Тестовые сообщения короткие, B2 по text на реальных 1000-символьных текстах дал бы больше. Источники и ИИ Документация PostgreSQL 16 (EXPLAIN, pg_dump, pg_indexes, pg_stat_user_indexes), pgx/v5, gin, go-redis v9, goose, RFC 9106. Материалы курса: contracts/openapi.json, contracts/README.md, tests/README.md. ChatGPT помогал сформулировать собственные тесты в student-tests/ и оформить отчёт по фактически полученным результатам. Архитектуру, код сервера и финальные тексты проверял и правил вручную. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Maximillan_Mercer added 61 commits 2026-10-03 09:18:19 +03:00
docs(report): lab2 fix commands in sh blocks
Skeleton contracts / contracts (pull_request) Canceled after 0s
8764332cf1
Author
First-time contributor

Я сегодня сдавал, у меня зачтено 5?

Я сегодня сдавал, у меня зачтено 5?
Owner

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

Принято на 5. Закрываю.
veprickiy closed this pull request 2026-10-03 13:15:22 +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#10