9.2 KiB
Отчёт по лабораторной работе № 2
- Студент: Борзов Никита
- Группа: БВТ2304
- Целевая оценка: 5
- Выбранный трек 5: трек 1, согласованность кэша
- Ветка:
solution/bvt2304-borzov - Commit:
f87929c - MR: #30
В этой работе я продолжил REST-мессенджер из лабораторной 1. In-memory-хранилище заменено на PostgreSQL, добавлены пароль при регистрации, Basic-аутентификация только для входа и непрозрачные Bearer-сессии. Redis используется для TTL-сессий и кэша списка чатов. Сессии записываются в Redis с AOF и переживают перезапуск API и Redis-volume.
Использованы контракт и публичные проверки из репозитория лабораторной 2, FastAPI, psycopg 3, PostgreSQL 16.4, Redis 7.4 и Argon2id из argon2-cffi. Код первой лабораторной и отчёт использованы как исходная предметная модель; при подготовке кода и проверки требований использовалась помощь ИИ, все команды и результаты проверены локально.
Запуск из чистого clone
Нужен Docker Desktop с Compose v2:
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose ps
make check
make test BASE_URL=http://localhost:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8080
Миграция scripts/migrate.py запускается внутри API до Uvicorn и идемпотентна. Для остановки без удаления данных используется docker compose stop; намеренный сброс учебного стенда выполняется отдельно командой docker compose down -v.
Архитектура и решения
Клиент -> FastAPI/Uvicorn -> PostgreSQL
└── Redis (сессии TTL + кэш списка чатов)
PostgreSQL является источником истины для пользователей, чатов, членства и сообщений. Таблицы, внешние ключи, уникальность username и индекс истории описаны в migrations/001_init.sql. Создание чата и его участников выполняется одной транзакцией. Пул PostgreSQL ограничен десятью соединениями.
Пароли хешируются Argon2id и никогда не возвращаются в User. Redis хранит session:<token> с TTL из SESSION_TTL_SECONDS; токен случайный, длиной не менее 256 бит. Redis включён с AOF everysec, поэтому действующая сессия сохраняется при обычном перезапуске контейнера с volume. Кэш chats:<user_id> живёт 30 секунд и удаляется при создании чата. После записи сообщение читается только из PostgreSQL, поэтому кэш не может скрыть подтверждённую запись.
Курсор истории кодирует (created_at, id) и используется в параметризованном keyset-запросе. Все ответы получают X-Request-Id и X-Instance-Id, ошибки имеют единый контракт и не содержат SQL или stack trace.
Доказательства критериев
| Критерий | Команда/сценарий | Наблюдаемый результат | Файл |
|---|---|---|---|
| Контракт и структура | make check |
PASS: offline skeleton structure |
вывод команды |
| OpenAPI-схема | make validate PYTHON=.venv/bin/python |
PASS: full OpenAPI 3.1 and JSON Schema validation |
вывод команды |
| Публичный smoke | make test |
PASS: lab2 public API scenario |
вывод команды |
| PostgreSQL и миграции | docker compose up -d --build |
API применяет 001_init.sql, данные находятся в PostgreSQL |
migrations/001_init.sql |
| Сохранность API/БД/сессии | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
подтверждённое сообщение и прежний Bearer-токен сохранены | scripts/restart.sh |
| Redis с TTL и volume | docker compose ps, redis-cli TTL session:* |
Redis healthy, TTL уменьшается, AOF включён | compose.yaml |
| Индекс истории | EXPLAIN (ANALYZE, BUFFERS) на 10 000 синтетических сообщениях |
Index Scan using messages_history_idx, 50 строк за 0.045 ms |
evidence/explain_history.txt |
| Уровень 4: race/rollback/expiry | python tests/level4.py при TTL=2 |
1 регистрация получила 201, 7 гонок — 409; невалидный чат не появился; просроченная сессия — 401 | tests/level4.py |
| Трек 5: кэш | python evidence/track_cache.py |
20 конкурентных холодных чтений дали 1 SQL-запрос; после очистки и рестарта Redis — 1 запрос на восстановление; запись инвалидирует ключ | evidence/track_cache.json |
Исследовательский трек: согласованность кэша
Гипотеза: Redis-кэш уменьшит задержку повторного чтения списка чатов, а явная инвалидация после создания чата сохранит read-after-write.
Методика: один синтетический пользователь на локальном Docker Compose, холодный GET /api/v1/chats, 30 последовательных чтений и 20 одновременных чтений после удаления ключа. Счётчик SQL-запросов включён только в локальном debug-режиме. В последнем прогоне получены cold 5.189 ms, warm p50 2.104 ms, warm p95 2.530 ms; 20 конкурентных запросов выполнили 1 SQL-чтение благодаря блокировке, после удаления ключа и рестарта Redis восстановление выполнило 1 SQL-чтение. После POST /api/v1/chats ключ пользователя удаляется; следующий GET заново читает PostgreSQL и возвращает новый чат. Ограничение измерения — один ноутбук и небольшой синтетический набор данных, поэтому результат показывает поведение защиты от stampede и направление задержки, а не универсальный RPS.
Эксперименты и отказы
| Воздействие | Ожидание | Наблюдение | Потеря данных |
|---|---|---|---|
Перезапуск API и Redis/PostgreSQL через scripts/restart.sh |
старый токен и подтверждённые данные сохраняются | публичный persistence-тест прошёл | 0 подтверждённых сообщений |
| Неверный Basic-пароль | одинаковый 401 и Basic challenge | проверено smoke | нет |
| Logout и повторный запрос | токен становится недействительным | DELETE возвращает 204, повтор — 401 | нет |
| Redis временно недоступен | readiness 503, анонимный запрос не принимается | получен HTTP 503 с unavailable, после запуска Redis — {"status":"ok"} |
нет; восстановление зависит от Redis |
| Короткий TTL | SESSION_TTL_SECONDS=2 ... tests/level4.py |
прежний токен получил 401 после истечения, гонка регистрации дала 1×201 и 7×409 | нет |
Ограничения и следующие шаги
Сессии зависят от Redis: при удалении его volume активные токены отзываются, хотя PostgreSQL-данные остаются. В обязательном API нет удаления пользователей/чатов и управления участниками. Для лаборатории 3 потребуется вынести идемпотентность сообщений и общие сессии на несколько API-реплик, сохранив этот PostgreSQL-контур.