Files
mtusi2026lab2/REPORT.md
T

6.2 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: Березин Герман / БВТ2304
  • Целевая оценка; выбранный трек 5, если нужен: 4
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: Go stdlib, jackc/pgx/v5, redis/go-redis/v9, golang.org/x/crypto/argon2, Docker Compose, PostgreSQL docs (transactions/EXPLAIN), Valkey persistence; contracts/openapi.json; ИИ — помощь в реализации по заданию; база — собственный lab1 (mtusi2026lab1-fork)

Запуск из чистого clone

Нужны: Docker + Compose, Python 3.9+, make, openssl. Go на хосте не обязателен.

cp .env.example .env
./scripts/mksecrets.sh
docker compose --env-file .env up -d --build
# дождаться /health/ready
make test
make test-own test-race test-rollback
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-expiry test-deps explain

Остановка: docker compose --env-file .env down (volumes сохраняются).
Намеренное удаление учебных данных: docker compose --env-file .env down -v.

Образы (pinned tag+digest):

  • golang:1.26-alpine@sha256:c95332c2af86b6d89b91bd0500f4b9529ccbd090a0d1855c6d1ceaa142ae8615
  • alpine:3.21@sha256:ce64758a109eb420d874a118f87920e625e12d3634e03b4a5573fd9f6e5d3507
  • postgres:17-alpine@sha256:b0f9560a2de083e2cc7382e75f808c7381a32852a7ec49117deedb300e552b24
  • valkey/valkey:8.1-alpine@sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507

Конфиг: APP_HOST, APP_PORT, APP_ENV, SESSION_TTL_SECONDS, SHUTDOWN_TIMEOUT_SECONDS, SESSION_STORE=postgres, DATABASE_URL_FILE, CACHE_URL_FILE. Секреты в ./secrets/ (не в git): postgres_password, database_url, cache_url.

Миграции применяются API при старте (embed + таблица schema_migrations); повторный запуск не дублирует схему/данные.

Архитектура и решения

Клиент → API (Go) → PostgreSQL (источник истины: users/chats/members/messages/sessions)
                  ↘ Valkey (кэш сессий sess:<sha256>, TTL = остаток жизни)

Перенесено из lab1: формат ошибок/X-Request-Id, валидация, keyset-cursor, graceful shutdown, multi-stage Dockerfile.
Изменено: RAM-store → PostgreSQL; X-User-Id → Basic login + opaque Bearer; добавлен Valkey как кэш.

Источник истины сессий — Postgres (sessions.token_hash = sha256(token), expires_at). Valkey — кэш; при miss/ошибке кэша читаем Postgres и (при успехе) пишем кэш. Logout: DELETE в Postgres + DEL в Valkey. TTL не продлевается рестартом.

Транзакции:

  • создание чата: одна tx insert chats + insert chat_members; FK/unknown member → rollback → 400;
  • регистрация: UNIQUE(username), гонка → SQLSTATE 23505 → 409;
  • сообщение: один INSERT.

Пул: MaxConns=10, MinConns=2, ConnectTimeout=3s, query timeout 3s; только параметризованные запросы.
Пароли: argon2id (m=65536,t=2,p=1). Токен: 32 random bytes (256 bit), base64url.
/health/ready проверяет только Postgres (Valkey некритичен).

Индекс истории: messages_history_idx (chat_id, created_at, id) под keyset
(created_at, id) > ($cursor) + ORDER BY created_at, id LIMIT n.
EXPLAIN на 10001 сообщении: Index Cond по messages_history_idx; OFFSET 5000 сортирует ≥5050 строк (evidence/explain.txt).

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke make test PASS lab2 public API evidence/smoke.txt
Offline check make check PASS skeleton evidence/smoke.txt
Persistence + session make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS; StartedAt api/postgres/valkey сменились, volumes сохранены evidence/persistence.txt
Own negative/auth make test-own 10 tests OK evidence/own-tests.txt
Race username make test-race created=1 conflict=19 evidence/race-register.txt
Rollback chat make test-rollback PASS, чат не в списке evidence/rollback.txt
Session expiry make test-expiry 200 → sleep → 401 при TTL=2 evidence/expiry.txt
Deps down make test-deps valkey down → 200; postgres down → 503/503 evidence/deps-down.txt
EXPLAIN index make explain Index Scan на messages_history_idx, 10001 msgs evidence/explain.txt

Эксперименты и отказы

Уровень 5 не заявлен.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
scripts/restart.sh (stop+start всех сервисов) тот же Bearer читает те же данные PASS persistence ~несколько секунд; данные в volumes
Valkey stop обход кэша, сессия из Postgres /users/me 200 мгновенно; без потери
Postgres stop ready/бизнес → 503 503/503 после start — 200, данные на месте
SESSION_TTL_SECONDS=2 после expiry 401 200 затем 401 сессия отозвана по времени

Ограничения и следующие шаги

Один API-процесс, нет LB/идемпотентности (lab3+). Valkey с AOF, но для оценки 4 он кэш, не единственное хранилище сессий. Нет delete API — тестовые данные копятся в volume. Следующий шаг курса — балансировка и idempotency.