5.7 KiB
5.7 KiB
Лабораторная 2
Автор / группа: Федотов Михаил, БВТ2302 Целевая оценка (3/4/5): 4 Трек 5: не заявлен
Что реализовано и что перенесено
- Реализован HTTP API на FastAPI; PostgreSQL хранит пользователей, чаты, участников и сообщения. Схема создаётся версионируемыми миграциями.
- Создание чата и его участников атомарно. История сообщений читается keyset-пагинацией по индексу
(chat_id, created_at, id). - Redis используется как хранилище сессий: непрозрачный Bearer-токен, фиксированный TTL, logout и AOF persistence. Пароли хешируются Argon2id; SQL-запросы параметризованы.
- Переход аутентификации объявлен: пароль задаётся при регистрации, Basic применяется только для
POST /auth/sessions, бизнес-запросы используют Bearer. Lab1 в исходном репозитории представлен skeleton; совместимость с прежнимX-User-Idкак механизмом доступа не сохраняется. Миграция 0002 удаляет старые сессии PostgreSQL, поэтому после обновления нужно войти заново.
Запуск из чистого clone
Из корня репозитория в WSL (нужны Docker Compose и Python 3):
cp -n .env.example .env
# Установить локальный POSTGRES_PASSWORD в .env.
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose ps # дождаться healthy у api, postgres и redis
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-grade4
docker compose --env-file .env down # тома сохраняются
Результаты проверок
make check— PASS;make test— PASS;make test-grade4— PASS, включая smoke и persistence.- Проверены параллельная регистрация (1 × 201, 7 × 409), неверный пароль (401), rollback создания чата, expiry сессии, отказы Redis/PostgreSQL с ограниченным 503 и восстановление после перезапуска.
EXPLAIN (ANALYZE, BUFFERS)на 10 000 синтетических сообщений выбралmessages_history_idx; страница из 50 строк прочитала 6 shared buffers. Это единичный замер плана запроса, не нагрузочный benchmark.- Реальный stdout сохранён в
evidence/make-check.txt,evidence/make-test.txt,evidence/make-test-grade4.txt,evidence/explain-history.txtи других файлах каталогаevidence/. - Подробное описание архитектуры, проверок и ограничений:
REPORT.md.
Ограничения / известные ошибки
- Уровень 5 и его экспериментальный трек не заявляются; пропускная способность под длительной нагрузкой и RTO/RPO не измерялись.
- Не проверялись восстановление из отдельной резервной копии и потеря/повреждение файлов Redis AOF при отказе хоста.
- При потере Redis аутентифицированные операции завершаются ограниченной ошибкой; резервного хранилища сессий нет.
- Старые PG-сессии при миграции 0002 отзываются; требуется повторный вход.
Источники и использование ИИ
Использованы материалы из README задания: PostgreSQL transactions, PostgreSQL EXPLAIN, Redis persistence и RFC 7617. При подготовке кода и документации использовался Codex (ИИ-ассистент); результат проверен командами и сценариями, указанными выше.
- Обязательный минимум текущего задания реализован; переход от lab1 и изменение аутентификации объявлены выше и в
REPORT.md. - Контракт и публичные тесты не ослаблялись.
make checkиmake testвыполнены; фактический stdout приложен вevidence/.- Проверены сценарии отказов и безопасности уровня 4.
.env, токены и приватные ключи в Git не добавлялись; доказательства обезличены.- Исходный README задания сохранён; инструкция запуска именно этой реализации находится в
REPORT.md.