Files
mtusi2026lab2/REPORT.md
T

10 KiB
Raw Blame History

Лабораторная 2. PostgreSQL, сессии и Valkey

Автор: Медведев Андрей Михайлович, БПИ2303. Целевая оценка: 5, трек 2 «План запроса и восстановление». Оценку выставляет преподаватель; здесь описаны реализация и результаты проверок.

Использованы Go 1.27.2, chi, oapi-codegen, pgx/v5, sqlc, goose, Argon2id и go-redis. Код, тесты и отчёт подготовлены при помощи Codex; независимый агент проверял транзакции, авторизацию, ресурсы и скрипты. Исходный skeleton: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2. Команды запуска и prerequisites находятся в RUN.md.

Архитектура

PostgreSQL хранит пользователей, хеши паролей, сессии, чаты, членство и сообщения. Valkey кэширует только неизменяемые открытые профили на 60 секунд. История и сессии не кэшируются: запись сразу читается из PostgreSQL, logout действует и при отказе Valkey. Ошибка кэша приводит к ограниченному обходу кэша, а не к анонимному доступу.

Из первой лабы перенесены доменные модели, keyset-пагинация, HTTP-адаптер, JSON-ошибки, ограниченная очередь и graceful shutdown. In-memory adapter заменён PostgreSQL. Core зависит от портов; SQL и HTTP-модели генерируются из схем, границы импортов проверяет depguard.

Создание чата, списание квоты и вставка всех участников выполняются одной транзакцией. Квота сообщения и его запись также атомарны. Регистрацию защищает UNIQUE(username), остальные связи защищены внешними ключами. Сетевых вызовов Valkey внутри SQL-транзакций нет.

Пароль содержит 12–128 Unicode code points, включая UTF-8 и двоеточия. Argon2id использует случайную соль 16 байт, память 32 МиБ, два прохода, один поток и результат 32 байта. Bearer содержит 32 случайных байта; в БД хранится только SHA-256 токена. Это хеширование высокоэнтропийного токена, а не замена password KDF.

Basic разрешён только при создании сессии. Срок жизни по умолчанию 3600 секунд; Bearer проверяется в PostgreSQL на каждом защищённом запросе. Logout удаляет сессию, рестарт не продлевает expiry. X-User-Id не предоставляет доступ и не меняет владельца Bearer.

Keyset-обход использует серверный timestamp PostgreSQL и UUID. Он стабилен для неизменного набора, но не является снимком: конкурентная транзакция может подтвердить строку с timestamp до уже пройденного курсора. Порядок подтверждения конкурентных записей не обещается.

Ресурсы и воспроизводимость

API ограничен одним CPU и 512 МиБ, PostgreSQL двумя CPU и 768 МиБ, Valkey 0,25 CPU и 128 МиБ. Пул PostgreSQL по умолчанию содержит не более восьми соединений; PG_MAX_CONNS допускает 1–64. Connect timeout равен 1 секунде, statement timeout 2 секундам, lock timeout 1 секунде, контекст обычного запроса 5 секундам. Обход кэша ограничен 80 мс.

Одновременно исполняются не более четырёх API-запросов; очередь и время ожидания ограничены. JSON body ограничен 64 КиБ. На пользователя допускаются 1000 созданных чатов, 1 млн сообщений и 100 действующих сессий. Квоты списываются атомарно, подтверждённые сообщения не вытесняются.

Compose создаёт именованные volumes. Credentials генерируются в .local/, не выводятся и исключены из git и build context. Версии образов закреплены digest. Отдельный migrate service применяет goose до API; повторный запуск использует текущую версию миграций. scripts/compose.sh явно закрепляет manifest и имя проекта.

Проверенные критерии

Критерий Проверка и результат Доказательство
Структура и OpenAPI make check и полная валидация схемы evidence/check.txt, evidence/validate.txt
Обязательный API Публичный smoke прошёл evidence/smoke.txt
Сохранность Прежний токен и сообщения сохранились после рестарта API, PostgreSQL и Valkey evidence/persistence.txt
Аутентификация Basic/Bearer, неверный пароль, logout, X-User-Id и короткий TTL проверены evidence/failures.txt
Регистрация Один 201 и один 409 при конкурентном одинаковом username evidence/acceptance.txt
Rollback Неизвестный участник даёт 400, чат не появляется evidence/acceptance.txt
Доступ и страницы Чужой чат скрыт; limit и обход без потерь/повторов проверены evidence/acceptance.txt
Отказ кэша Действующая сессия работает через PostgreSQL, анонимного доступа нет evidence/failures.txt
Отказ БД Запрос и readiness дают 503, liveness работает evidence/failures.txt
Индекс истории 100 тыс. сообщений, два индекса и стоимость вставок evidence/research/run-16q3rN/
Восстановление Бэкап восстановлен в отдельный PostgreSQL container/volume evidence/research/run-16q3rN/summary.json

Исследование индекса и восстановления

Гипотеза: индекс только по chat_id требует сортировки оставшейся истории, а составной (chat_id,created_at,id) позволяет сразу читать продолжение в порядке ключей. Создано 100 000 сообщений в трёх чатах с распределением 90 000 / 9000 / 1000. Для горячего чата запрошена глубокая страница из 51 строки после позиции 70 000; дополнительная строка определяет next_cursor.

EXPLAIN (ANALYZE, BUFFERS) дал 7,009 → 0,072 мс. Вставка 1000 строк заняла 16,243 → 16,610 мс. Это наблюдение одной пары на данном наборе, а не универсальная оценка стоимости записи. Польза чтения также подтверждается планом и отсутствием сортировки большой оставшейся истории; все исходные планы сохранены.

Затем pg_dump восстановлен в новую БД отдельного PostgreSQL с собственным volume. Бэкап содержит 3 034 766 байт; создание заняло примерно 0,49 секунды, pg_restore в подготовленную БД примерно 1,51 секунды. Сошлись 7 пользователей, 5 чатов, 7 membership и 102 003 сообщения, включая 102 000 исследовательских строк после двух серий вставок. Совпали ID, текст и время выбранных сообщений.

API был остановлен на время снимка, поэтому потери относительно снимка для этой остановленной нагрузки нет. Время pg_restore не включает подготовку host/образа, переключение приложения и восстановление трафика. Непрерывное восстановление по WAL, репликация PostgreSQL и отказ host не реализованы.

Исследовательский скрипт создаёт отдельный каталог запуска, проверяет отсутствие игры, восстанавливает штатный индекс и API, удаляет только собственные исследовательские UUID. PASS и итоговый summary появляются после уборки. Новый запуск не подменяет старое успешное доказательство.

Защита

Показать регистрацию и Basic-вход, чтение по Bearer и отказ X-User-Id. Запустить persistence hook и прочитать прежнее сообщение тем же токеном, затем выполнить logout и получить 401. Объяснить разницу COMMIT и backup, роль кэша и составного индекса. Показать план запроса и результаты восстановления, отдельно назвать неподдержанные отказы.