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с персистентностью AOFappendfsync 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 содержит инструкцию именно моего решения.