Files
mtusi2026lab2/REPORT.md
T

60 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Лабораторная 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](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, роль кэша и составного индекса. Показать план запроса и результаты восстановления, отдельно назвать неподдержанные отказы.