Shiyan BVT2304 - 4 #48

Closed
BVT2304_Shiyan wants to merge 2 commits from BVT2304_Shiyan/mtusi2026lab2:solution/BVT2304-Shiyan into master
First-time contributor

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

Автор / группа: BVT2304, Shiyan
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 1 «Согласованность кэша» (stale read + cache stampede → защита версионированием ключа и single-flight; замеры SQL-запросов и latency до/после)

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

Перенесено из lab1 (с объявленным переходом 1→2): структура API-слоя (router.go, handlers.go, middleware.go, helpers.go, apperr/), graceful shutdown (SIGTERM → ready=false → Shutdown с бюджетом 8 c), healthcheck live/ready, таймауты HTTP-сервера, Dockerfile (multi-stage, non-root, exec-форма ENTRYPOINT → PID 1), детерминированная сериализация Timestamp, дженерик Page[T], keyset-курсоры base64url со scope, конверт ошибок.

Реализовано в lab2:

  • PostgreSQL 16 как источник истины: пользователи, чаты, участники, сообщения и сессии; версионируемая миграция 0001_init.sql (PK/FK/UNIQUE username/индексы), встроена в бинарник через go:embed, идемпотентна (IF NOT EXISTS), применяется при старте до приёма трафика.
  • Аутентификация по контракту lab2: регистрация с password (KDF scrypt, формат scrypt$N$r$p$salt$hash, constant-time сравнение); вход только Basic на POST /auth/sessions (разбор по первой двоеточке — двоеточие в пароле допустимо); opaque Bearer-токен 256 бит (32 байта crypto/rand), серверно храним SHA-256(token); expiry через SESSION_TTL_SECONDS (не продлевается рестартом), logout DELETE /auth/sessions/current → 204; X-User-Id игнорируется; одинаковый 401 + WWW-Authenticate для неизвестного пользователя и неверного пароля.
  • Атомарность: создание чата — одна транзакция (проверка участников → INSERT chat → INSERT members); гонка регистрации решается UNIQUE-ограничением (SQLSTATE 23505 → 409).
  • Уровень 4: Redis 7 как кэш сессий и истории с политиками expiry/инвалидации (TTL кэш-ключа сессии = остаток expires_at; инвалидация при logout/просрочке); деградация при потере Redis (таймаут операции 300 мс → warn → SQL), при потере Postgres — 503 на ready и защищённых путях, аноним по-прежнему 401; параметризованные запросы pgx; пул MaxConns=10 + ConnectTimeout=5s + statement_timeout=15s; индекс истории обоснован EXPLAIN (ANALYZE, BUFFERS) на 30 002 сообщениях.
  • Трек 5: режимы CACHE_MODE=off|naive|versioned; демонстрация stale read (naive) и stampede (off: 32 SQL на 32 холодных чтения); защита — версия чата в ключе кэша (INCR на COMMIT → старые ключи мертвы, read-after-write сохранён) + single-flight (32 холодных чтения → 1 SQL); восстановление после docker compose restart redis.
  • Инфраструктура: compose.yaml (api + postgres + redis, закреплённые теги образов, именованные volumes, healthchecks), .env.example → локальный .env (вне Git), scripts/restart.sh и scripts/restart.bat (перезапуск API и обоих хранилищ без удаления volumes), scripts/explain_demo.bat, scripts/cache_demo.bat, scripts/expiry.bat.

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

git clone <url fork> && cd <repo> && git checkout solution/BVT2304-Shiyan
cp .env.example .env                      # локальные secrets, вне Git
docker compose --env-file .env up -d --build
docker compose ps                         # ждать healthy у api/postgres/redis
curl http://localhost:8080/health/ready   # 200 {"status":"ok"}

make check
make test                                 # публичный smoke
make test-persistence ACTION_SCRIPT=scripts/restart.sh   # на Windows: scripts\restart.bat
python student-tests/run_tests.py --base-url http://localhost:8080
python student-tests/failover_tests.py --base-url http://localhost:8080
scripts/expiry.bat                        # expiry при TTL=2
scripts/cache_demo.bat                    # эксперимент трека 5 (off→naive→versioned→recovery)
scripts/explain_demo.bat                  # EXPLAIN-доказательство индекса

docker compose down                       # безопасная остановка (volumes сохраняются)
docker compose down -v                    # НАМЕРЕННОЕ удаление учебных данных
## Лабораторная 2 **Автор / группа:** BVT2304, Shiyan **Целевая оценка (3/4/5):** 5 **Трек 5, если заявлен:** Трек 1 «Согласованность кэша» (stale read + cache stampede → защита версионированием ключа и single-flight; замеры SQL-запросов и latency до/после) ### Что реализовано и что перенесено **Перенесено из lab1 (с объявленным переходом 1→2):** структура API-слоя (`router.go`, `handlers.go`, `middleware.go`, `helpers.go`, `apperr/`), graceful shutdown (SIGTERM → ready=false → `Shutdown` с бюджетом 8 c), healthcheck live/ready, таймауты HTTP-сервера, Dockerfile (multi-stage, non-root, exec-форма ENTRYPOINT → PID 1), детерминированная сериализация `Timestamp`, дженерик `Page[T]`, keyset-курсоры base64url со `scope`, конверт ошибок. **Реализовано в lab2:** - PostgreSQL 16 как источник истины: пользователи, чаты, участники, сообщения **и сессии**; версионируемая миграция `0001_init.sql` (PK/FK/UNIQUE username/индексы), встроена в бинарник через `go:embed`, идемпотентна (`IF NOT EXISTS`), применяется при старте до приёма трафика. - Аутентификация по контракту lab2: регистрация с `password` (KDF scrypt, формат `scrypt$N$r$p$salt$hash`, constant-time сравнение); вход только `Basic` на `POST /auth/sessions` (разбор по первой двоеточке — двоеточие в пароле допустимо); opaque Bearer-токен 256 бит (32 байта `crypto/rand`), серверно храним `SHA-256(token)`; expiry через `SESSION_TTL_SECONDS` (не продлевается рестартом), logout `DELETE /auth/sessions/current` → 204; `X-User-Id` игнорируется; одинаковый 401 + `WWW-Authenticate` для неизвестного пользователя и неверного пароля. - Атомарность: создание чата — одна транзакция (проверка участников → INSERT chat → INSERT members); гонка регистрации решается UNIQUE-ограничением (SQLSTATE 23505 → 409). - Уровень 4: Redis 7 как кэш сессий и истории с политиками expiry/инвалидации (TTL кэш-ключа сессии = остаток `expires_at`; инвалидация при logout/просрочке); деградация при потере Redis (таймаут операции 300 мс → warn → SQL), при потере Postgres — 503 на ready и защищённых путях, аноним по-прежнему 401; параметризованные запросы pgx; пул `MaxConns=10` + `ConnectTimeout=5s` + `statement_timeout=15s`; индекс истории обоснован `EXPLAIN (ANALYZE, BUFFERS)` на 30 002 сообщениях. - Трек 5: режимы `CACHE_MODE=off|naive|versioned`; демонстрация stale read (naive) и stampede (off: 32 SQL на 32 холодных чтения); защита — версия чата в ключе кэша (`INCR` на COMMIT → старые ключи мертвы, read-after-write сохранён) + single-flight (32 холодных чтения → 1 SQL); восстановление после `docker compose restart redis`. - Инфраструктура: `compose.yaml` (api + postgres + redis, закреплённые теги образов, именованные volumes, healthchecks), `.env.example` → локальный `.env` (вне Git), `scripts/restart.sh` и `scripts/restart.bat` (перезапуск API и обоих хранилищ без удаления volumes), `scripts/explain_demo.bat`, `scripts/cache_demo.bat`, `scripts/expiry.bat`. ### Команды запуска из чистого clone ```bash git clone <url fork> && cd <repo> && git checkout solution/BVT2304-Shiyan cp .env.example .env # локальные secrets, вне Git docker compose --env-file .env up -d --build docker compose ps # ждать healthy у api/postgres/redis curl http://localhost:8080/health/ready # 200 {"status":"ok"} make check make test # публичный smoke make test-persistence ACTION_SCRIPT=scripts/restart.sh # на Windows: scripts\restart.bat python student-tests/run_tests.py --base-url http://localhost:8080 python student-tests/failover_tests.py --base-url http://localhost:8080 scripts/expiry.bat # expiry при TTL=2 scripts/cache_demo.bat # эксперимент трека 5 (off→naive→versioned→recovery) scripts/explain_demo.bat # EXPLAIN-доказательство индекса docker compose down # безопасная остановка (volumes сохраняются) docker compose down -v # НАМЕРЕННОЕ удаление учебных данных
BVT2304_Shiyan added 2 commits 2026-10-15 10:37:57 +03:00
lab2 - оценка 5
Skeleton contracts / contracts (pull_request) Canceled after 0s
f07ad1e097
lab2 - оценка 4
Skeleton contracts / contracts (pull_request) Canceled after 0s
7b0088a033
Owner

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

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