Files
mtusi2026lab2/.github/pull_request_template.md
T
2026-11-03 13:30:21 +03:00

4.4 KiB

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

Автор / группа: Заморский Павел, БВТ2302 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 2 (План запроса на ≥100 000 сообщениях с неравномерными размерами чатов и backup/restore) + Трек 1 (Согласованность кэша, защита от cache stampede и read-after-write)

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

  • Перенесён HTTP API из ЛР1 (cmd/server, internal/handler, internal/model) с переводом хранения на PostgreSQL 18 (postgres:18-alpine, pgx/v5, пул соединений pgxpool, транзакции и таймауты) и кэшированием/хранением сессий в Redis 7.4 (redis:7.4-alpine с персистентностью AOF appendfsync everysec).
  • Добавлены версионируемые идемпотентные SQL-миграции (migrations/001_init.sql + таблица schema_migrations).
  • Реализована регистрация с хешированием паролей через Argon2id (golang.org/x/crypto/argon2, параметры m=19456, t=1, p=2), вход через POST /api/v1/auth/sessions (Authorization: Basic <base64(username:password)> с поддержкой двоеточий в пароле и защитой от timing-атак), выдача криптостойких 256-битных opaque Bearer-токенов (хранятся в виде SHA-256 дайджестов) и отзыв сессии через DELETE /api/v1/auth/sessions/current.
  • Подготовлен compose.yaml с именованными volumes (mtusi_lab2_pgdata, mtusi_lab2_redisdata), проверками healthcheck и скриптом полного перезапуска scripts/restart.sh.

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

cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-grade4
make test-track1
make test-track2

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

  • Все публичные (make check, make test, make test-persistence) и дополнительные (make test-grade4, make test-track1, make test-track2) проверки проходят со статусом PASS. Подробный разбор, планы EXPLAIN (ANALYZE, BUFFERS) и метрики приведены в REPORT.md и директории evidence/.

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

  • API работает в одной реплике (горизонтальное масштабирование за балансировщиком и Idempotency-Key предусмотрены в ЛР3).
  • При полном отказе PostgreSQL сервис ожидаемо возвращает 503 unavailable (так как PostgreSQL является единственным источником истины), а при отказе Redis прозрачно переходит на чтение из PostgreSQL.

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

  • Документация PostgreSQL 18 (Transactions, EXPLAIN, B-Tree indexes), RFC 7617 (HTTP Basic Auth), OWASP Password Storage Cheat Sheet (Argon2id), документация пакетов jackc/pgx/v5 и redis/go-redis/v9. Помощь ИИ (Google Antigravity) при генерации шаблонов тестов, нагрузочных скриптов и оформлении отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.

  • Контракт и публичные тесты не ослаблены.

  • make check и make test выполнены; приложен реальный вывод.

  • Сценарии отказов/безопасности своего уровня воспроизведены.

  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.

  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.