ЛР 2 — БВТ2302 — Заморский — на 5 #168

Closed
0pavel1 wants to merge 1 commits from 0pavel1/mtusi2026lab2:solution/bvt2302-zamorskiy into master
First-time contributor

Лабораторная 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. Помощь ИИ при генерации шаблонов тестов, нагрузочных скриптов и оформлении отчёта.

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

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

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

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

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

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

## Лабораторная 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: ```sh 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](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`. Помощь ИИ при генерации шаблонов тестов, нагрузочных скриптов и оформлении отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
0pavel1 added 1 commit 2026-11-10 11:51:08 +03:00
0pavel1 changed title from feat(lab2): PostgreSQL 18 persistence, Argon2id auth, Redis 7.4 sessions & cache, Grade 5 tracks to ЛР 2 — БВТ2302 — Заморский — на 5 2026-11-10 11:52:42 +03:00
andrey.derbenev closed this pull request 2026-11-12 15:31:12 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#168