Автор / группа: 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 # НАМЕРЕННОЕ удаление учебных данных
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 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:
0001_init.sql(PK/FK/UNIQUE username/индексы), встроена в бинарник черезgo:embed, идемпотентна (IF NOT EXISTS), применяется при старте до приёма трафика.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(не продлевается рестартом), logoutDELETE /auth/sessions/current→ 204;X-User-Idигнорируется; одинаковый 401 +WWW-Authenticateдля неизвестного пользователя и неверного пароля.expires_at; инвалидация при logout/просрочке); деградация при потере Redis (таймаут операции 300 мс → warn → SQL), при потере Postgres — 503 на ready и защищённых путях, аноним по-прежнему 401; параметризованные запросы pgx; пулMaxConns=10+ConnectTimeout=5s+statement_timeout=15s; индекс истории обоснованEXPLAIN (ANALYZE, BUFFERS)на 30 002 сообщениях.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
Принято. Закрываю МР.
Pull request closed