9.2 KiB
Отчёт — лабораторная 2
- Автор, группа: заполнить перед сдачей
- Целевая оценка; выбранный трек 5, если нужен: 4; трек 5 не заявлен
- Commit/PR: TODO после публикации
- Использованные библиотеки: FastAPI, psycopg 3 connection pool, redis-py, argon2-cffi/Argon2id.
- Перенесён минимум lab1: регистрация пользователя, профиль
/users/me, создание/список/чтение чатов, сообщения и keyset-пагинация. API-изменение объявлено: password при регистрации, Basic только на создание сессии, Bearer на все защищённые операции;X-User-Idне является способом аутентификации.
Запуск из чистого clone
Prerequisites, выпуск локального secret, запуск, проверки, безопасная остановка и осознанное удаление volumes документированы в README.md. Образы закреплены тегами в compose.yaml, приложение строится из Dockerfile. Перед сдачей запишите проверенные версии Docker/Compose и Python, а также фактические команды и результаты запуска.
Архитектура и решения
API (FastAPI) обслуживает синхронные HTTP-запросы; PostgreSQL хранит пользователей, чаты, участников, сообщения и сессии; Redis хранит кэш профиля сессии. PostgreSQL — источник истины данных и состояния сессии. На каждом Bearer-запросе expiry/revocation сверяются с PostgreSQL; при cache miss Redis заполняется профилем из БД, при отказе Redis профиль читается из БД. Redis TTL не длиннее expires_at; logout фиксирует отзыв в БД и затем удаляет кэш. Недоступность Redis не ослабляет аутентификацию, недоступность PostgreSQL приводит к ограниченному 503.
До реализации запросов зафиксирована схема и границы транзакций в README. Миграция 001_initial.sql определяет PK/FK/CHECK/UNIQUE и индексы chat_members_by_user, messages_history_keyset и sessions_active_by_expiry. app/migrate.py применяет версионированные миграции транзакционно и пропускает уже применённую версию. Создание чата и всех строк chat_members выполняется в одной транзакции; ошибка любой вставки откатывает операцию. История читает limit + 1 запись по keyset (created_at, id), без OFFSET и полного сканирования истории на каждой странице.
Пул ограничен DB_POOL_MAX_SIZE (по умолчанию 10; допустимо 1–50), checkout timeout 2 секунды, connect timeout 3 секунды, statement timeout 5 секунд и lock timeout 3 секунды. Пароли Argon2id; сессионный bearer — 256-битное случайное значение, в БД хранится только SHA-256 token fingerprint. Переносится функциональный минимум API lab1, а не его in-memory формат хранения.
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | make test |
PASS на Compose, API + PostgreSQL 16.6 + Redis | local-validation.txt |
| Полный перезапуск с volume | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS: после рестарта API, PostgreSQL и Redis прежний Bearer-токен читает сохранённые данные | local-validation.txt |
| Регистрация и негативные проверки | make test-grade4 |
PASS на Compose: гонка username, неверный пароль, logout, Redis fallback, 503 при остановке PostgreSQL и восстановление | local-validation.txt |
| Rollback создания чата | make test-rollback |
PASS на Compose PostgreSQL с инъекцией ошибки при вставке второго участника; чат и первая membership-запись откатились | local-validation.txt |
| TTL и expiry | SESSION_TTL_SECONDS=2 docker compose up -d --force-recreate api; make test-expiry |
PASS на Compose: после expiry прежний token получает 401; после теста восстановлен TTL 3600 | local-validation.txt |
| План индекса на 10 000 сообщениях | make explain-history |
PASS на Compose PostgreSQL 16.6: Index Scan using messages_history_keyset, 51 rows actual, 3 shared buffer hits |
local-validation.txt |
| Все пункты уровня 4 | Команды выше | Проверены на локальном Compose-стенде с PostgreSQL и Redis; результаты и границы эксперимента приведены ниже. | local-validation.txt |
Результаты относятся к локальному учебному Compose-стенду и синтетическим данным.
Эксперименты и отказы
Повторная проверка 2026-11-10 выполнена на отдельном Compose-проекте с чистыми именованными volumes, PostgreSQL 16.6 и Redis 7.4.2. make check, make validate, make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh, make test-grade4, make test-rollback, make test-expiry с SESSION_TTL_SECONDS=2 и make explain-history прошли. Этот прогон заменяет предыдущие статусы отказа в таблице ниже. После expiry восстановлен TTL 3600; повторный smoke прошёл. Миграция 001_initial.sql записана один раз. EXPLAIN (ANALYZE, BUFFERS) для 10 000 сообщений выбрал messages_history_keyset: 51 строка, 3 shared buffer hits, 0.034 ms execution. В проверке rollback тестовый триггер после проверки удалён.
Гипотеза для плана: индекс (chat_id, created_at, id) поддержит фильтрацию по чату и keyset-сортировку без полного прохода истории. 2026-11-09 эксперимент выполнен на Compose PostgreSQL 16.6, 10 000 синтетических строк внутри транзакции; после ANALYZE план выбрал Index Scan using messages_history_keyset, 51 строка прочитана за 0.031 ms, Buffers: shared hit=3, планирование — 0.130 ms. Fixture после ROLLBACK не сохранялся. Это один прогретый запуск и не оценка latency под нагрузкой. Дополнительный локальный PostgreSQL 16.11 результат от 2026-10-30 сохранён в evidence.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
| Остановка Redis | Bearer запрос продолжит работать через PostgreSQL | Не проверено с реальным Redis; локальная интеграция использовала test double | local-validation.txt |
| Остановка PostgreSQL | ready и защищённый запрос вернут 503; анонимный доступ не появляется | Не проверено: Docker API перестал отвечать в ходе валидации | local-validation.txt |
Ограничения и следующие шаги
Стенд single-node и не гарантирует HA при потере Docker host или volume. Redis — кэш, поэтому кэшированные профили можно восстановить из PostgreSQL; AOF настроен для сохранности Redis volume, но его потеря не должна терять сессии. Вложения, API нескольких реплик и треки уровня 5 не реализованы.