Files
mtusi2026lab2-fork/REPORT.md
T

9.6 KiB
Raw Blame History

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

  • Автор, группа: Гришко Дмитрий Михайлович, БВТ2303
  • Целевая оценка: 3
  • Ветка: solution/BVT2303-grishko
  • Источники: задание, контракт, проверки, golang-migrate, документация PostgreSQL и Go
  • Зависимости: Go 1.22.2, PostgreSQL 16.10, pgx/v5, golang-migrate/v4, x/crypto/scrypt, google/uuid; помощь ИИ: OpenAI Codex — реализация и проверка кода

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

Нужны Docker Engine с Compose, Python 3.9+ и Make. Go нужен для go test ./... вне контейнера. Команды приведены для Linux/WSL в корне репозитория.

cp .env.example .env
sed -i "s/replace-with-local-random-password/$(openssl rand -hex 24)/" .env
make check
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
go test ./...

.env содержит локальный пароль и исключён из Git. База доступна только внутри Compose-сети; HTTP API опубликован на 127.0.0.1:8080. Миграции up применяются автоматически перед запуском HTTP-сервера. Они встроены в бинарник из src/migrations. Применение вручную: docker compose --env-file .env run --rm --no-deps api migrate up при уже запущенной БД. Откат одной версии, удаляющий таблицы и данные этой начальной миграции, выполняется только сознательно при остановленном API: docker compose --env-file .env stop api, затем docker compose --env-file .env run --rm --no-deps api migrate down.

Безопасная остановка: docker compose --env-file .env down — volume сохранится. Намеренное удаление учебных данных: docker compose --env-file .env down -v. После смены пароля в .env для уже инициализированного volume надо отдельно менять пароль роли PostgreSQL; изменение одной строки .env существующую роль не обновляет.

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

HTTP-клиент → Go net/http API → PostgreSQL (именованный volume postgres_data)

Перенесены модели, маршруты, валидация JSON и курсоры из лабораторной 1. Методы userStore, chatStore и messageStore переписаны на PostgreSQL; прежние in-memory коллекции удалены. Публичная регистрация теперь требует пароль. На POST /auth/sessions допускается только Basic; остальные защищённые маршруты проходят через проверку Bearer. Идентификатор пользователя передаётся обработчикам через контекст запроса, X-User-Id игнорируется.

Таблица Ключи и ограничения Назначение
users PK id, UNIQUE username, CHECK длины и формата Пользователи и хеши паролей
chats PK id, CHECK длины названия Чаты
chat_members PK (chat_id,user_id), FK на обе таблицы, индекс (user_id,chat_id) Членство и выборка доступных чатов
messages PK id, FK на чат и отправителя, индекс (chat_id,created_at,id) История и keyset-пагинация
sessions PK token_hash, FK user_id, индекс expires_at Действующие сессии

Создание чата и всех записей членства — одна транзакция: при ошибке ни чат, ни часть участников не сохраняются. Регистрация, отправка сообщения, выдача и отзыв сессии — отдельные атомарные SQL-операции. Все параметры передаются через pgx, а не собираются в SQL-строку. Чтение истории выполняет ORDER BY created_at,id LIMIT limit+1 с условием курсора. Часы назначения времени находятся в API; при конкурентных вставках между страницами snapshot всей истории не обещается.

Пароль обрабатывается scrypt со случайной 32-байтной солью (N=32768,r=8,p=1). В БД у пользователя только колонка password_hash: её 64 байта содержат соль и производный ключ подряд. Это нужно для повторной проверки пароля; значение не входит в API-ответ. Токен сессии содержит 256 случайных бит, клиент получает его один раз, в БД хранится только SHA-256 токена. Истечение проверяется по expires_at при каждом запросе, logout удаляет строку. Это не продлевает TTL при рестарте. PostgreSQL — источник истины для всех данных и сессий. GET /health/ready проверяет доступность БД.

golang-migrate хранит номер версии и признак незавершённой миграции в schema_migrations. Есть ровно одна парная миграция: 000001_initial.up.sql и .down.sql; повторный up не создаёт данные заново. Миграция down проверялась только на отдельной временной БД.

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

Критерий Команда/сценарий Результат
Контракт и код make check, go test ./..., go vet ./... PASS
PostgreSQL и миграция с нуля migrate up на пустой временной БД версия 1, dirty=false, таблица users создана
Применение и откат migrate up → down → up на временной БД все три команды PASS; в конце версия 1, dirty=false
Базовый API, Basic, Bearer, доступ, logout make test PASS, публичный сценарий lab2
Сохранность данных и действующей сессии make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS с прежним токеном после рестарта API и БД
Срок жизни сессии API с SESSION_TTL_SECONDS=2, вход, чтение, ожидание 3 с, чтение после истечения получен 401; затем восстановлен TTL 3600
Повтор миграции и volume повторный запуск API после рестарта данные сохранены, версия миграции осталась 1

make test также проверяет неверный пароль, Basic на бизнес-маршруте и невозможность доступа по одному X-User-Id. Токены и пароли не сохранялись в отчёте.

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

Воздействие Ожидание Наблюдение
scripts/restart.sh API и БД перезапускаются без удаления volume время запуска БД изменилось с 18:55:34Z на 18:56:24Z, API — с 18:55:38Z на 18:56:27Z; число пользователей/чатов/сообщений/миграций было и осталось 6/2/3/1; persistence-сценарий PASS
TTL 2 секунды истёкший токен отклоняется после 3 секунд 401
migrate down на временной БД откат начальной схемы версия 1 удалена; повторный up снова создал схему

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

Одна копия API и одна БД не дают отказоустойчивости при потере хоста/volume. Рестарт с сохранённым volume проверен, резервное копирование и восстановление не реализованы. Redis/Valkey, нагрузочные измерения и EXPLAIN относятся к уровню 4 и здесь не заявлены. HTTP и пароль в локальном .env предназначены только для изолированного учебного стенда с синтетическими данными. DATABASE_URL доступен оператору Docker в окружении контейнера. Для удалённого размещения нужны TLS и управление секретами.