ЛР 2 — БВТ2304 — Кузнецова — на 5 #17

Closed
queenfish wants to merge 2 commits from queenfish/mtusi2026lab2:solution/kuznetsova-bvt2304 into master
First-time contributor

Лабораторная 2

Автор / группа: Кузнецова Марина / БВТ2304

Целевая оценка: 5

Трек 5: Трек 1 – согласованность кэша

Что реализовано:

  • PostgreSQL как источник истины для пользователей, чатов, участников и сообщений;

  • версионируемые миграции с нуля: users, chats, chat_members, messages, sessions;

  • регистрация с паролем, хеширование через Argon2id;

  • аутентификация Basic → Bearer: вход через POST /auth/sessions, opaque-токен, TTL, logout через DELETE /auth/sessions/current;

  • X-User-Id с lab2 игнорируется, все бизнес-эндпоинты требуют Bearer;

  • Valkey (Redis-совместимый) для сессий с TTL и с persistence (--appendonly yes);

  • ограниченный connection pool asyncpg с таймаутами;

  • индекс idx_messages_chat_created на (chat_id, created_at, id), проверен через EXPLAIN (ANALYZE, BUFFERS) на 10000 сообщениях;

  • /health/ready проверяет PostgreSQL и Valkey, отдаёт 503 при недоступности;

  • Docker Compose: три сервиса (postgres, valkey, api), volumes для данных;

  • скрипт перезапуска scripts/restart.sh и Python-версия restart.py для локальной отладки;

  • свои тесты: гонка регистрации, rollback составной операции, expiry, недоступность Redis/БД, read-after-write, восстановление кэша после рестарта;

  • Трек 1: cache stampede показан на baseline (50 SQL при 50 параллельных GET), предотвращён через single-flight (SET NX в Redis) – 50 → 1 SQL; read-after-write доказан.

Команды запуска из чистого clone:

  • cp .env.example .env

  • docker compose --env-file .env up -d --build

  • python tests/smoke.py --base-url http://localhost:8080

  • pytest student-tests/ -v

  • python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8080

Результаты проверок и ссылка на REPORT.md:

  • python tests/smoke.py --base-url http://localhost:8080 – PASS: lab2 public API scenario.

  • pytest student-tests/ -v – 17 passed. Проверяются гонка регистрации, rollback составной операции, expiry при коротком TTL, logout, неверный пароль, недоступность Redis и PostgreSQL, read-after-write, восстановление кэша после рестарта Valkey, а также все негативные сценарии lab1 с новой аутентификацией.

  • python tests/resilience.py --mode persistence ... – PASS: данные и активная сессия переживают перезапуск API и PostgreSQL без удаления volumes.

  • EXPLAIN (ANALYZE, BUFFERS) на 10000 сообщениях – Index Scan using idx_messages_chat_created, 0.087 мс против 2.533 мс при Seq Scan (29× быстрее). Сохранено в evidence/explain.txt.

  • Трек 1: при 50 параллельных GET на холодный кэш число SQL-запросов к таблице messages снизилось с 50 до 1. Сырые результаты в evidence/cache_experiment.json, разбор – в REPORT.md.

  • Отчёт: REPORT.md.

Ограничения / известные ошибки:

  • Одна реплика API, балансировки нагрузки нет.

  • Сессии и кэш используют одну базу Valkey (db 0) с разными префиксами ключей.

  • Кэш не инвалидируется, если данные изменены напрямую в БД в обход API (в обычной работе это не происходит).

  • HTTP без TLS.

Источники и использование ИИ:

  • материалы курса, OpenAPI-контракт и документация FastAPI, asyncpg, redis-py, PostgreSQL EXPLAIN, Docker Compose; ИИ использовался для пояснения требований задания, обсуждения архитектуры и проверки корректности реализации.

Чек-лист:

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.

  • Контракт и публичные тесты не ослаблены.

  • Прямые проверки python tests/smoke.py, pytest student-tests/, python tests/resilience.py и EXPLAIN выполнены; результаты приведены в REPORT.md.

  • Сценарии отказов своего уровня воспроизведены.

  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.

  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.

Ссылка на файл REPORT.md

## Лабораторная 2 Автор / группа: Кузнецова Марина / БВТ2304 Целевая оценка: 5 Трек 5: Трек 1 – согласованность кэша Что реализовано: - PostgreSQL как источник истины для пользователей, чатов, участников и сообщений; - версионируемые миграции с нуля: users, chats, chat_members, messages, sessions; - регистрация с паролем, хеширование через Argon2id; - аутентификация Basic → Bearer: вход через POST /auth/sessions, opaque-токен, TTL, logout через DELETE /auth/sessions/current; - X-User-Id с lab2 игнорируется, все бизнес-эндпоинты требуют Bearer; - Valkey (Redis-совместимый) для сессий с TTL и с persistence (--appendonly yes); - ограниченный connection pool asyncpg с таймаутами; - индекс idx_messages_chat_created на (chat_id, created_at, id), проверен через EXPLAIN (ANALYZE, BUFFERS) на 10000 сообщениях; - /health/ready проверяет PostgreSQL и Valkey, отдаёт 503 при недоступности; - Docker Compose: три сервиса (postgres, valkey, api), volumes для данных; - скрипт перезапуска scripts/restart.sh и Python-версия restart.py для локальной отладки; - свои тесты: гонка регистрации, rollback составной операции, expiry, недоступность Redis/БД, read-after-write, восстановление кэша после рестарта; - Трек 1: cache stampede показан на baseline (50 SQL при 50 параллельных GET), предотвращён через single-flight (SET NX в Redis) – 50 → 1 SQL; read-after-write доказан. Команды запуска из чистого clone: - `cp .env.example .env` - `docker compose --env-file .env up -d --build` - `python tests/smoke.py --base-url http://localhost:8080` - `pytest student-tests/ -v` - `python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8080` Результаты проверок и ссылка на REPORT.md: - `python tests/smoke.py --base-url http://localhost:8080` – PASS: lab2 public API scenario. - `pytest student-tests/ -v` – 17 passed. Проверяются гонка регистрации, rollback составной операции, expiry при коротком TTL, logout, неверный пароль, недоступность Redis и PostgreSQL, read-after-write, восстановление кэша после рестарта Valkey, а также все негативные сценарии lab1 с новой аутентификацией. - `python tests/resilience.py --mode persistence ...` – PASS: данные и активная сессия переживают перезапуск API и PostgreSQL без удаления volumes. - `EXPLAIN (ANALYZE, BUFFERS)` на 10000 сообщениях – Index Scan using idx_messages_chat_created, 0.087 мс против 2.533 мс при Seq Scan (29× быстрее). Сохранено в evidence/explain.txt. - Трек 1: при 50 параллельных GET на холодный кэш число SQL-запросов к таблице messages снизилось с 50 до 1. Сырые результаты в evidence/cache_experiment.json, разбор – в REPORT.md. - Отчёт: `REPORT.md`. Ограничения / известные ошибки: - Одна реплика API, балансировки нагрузки нет. - Сессии и кэш используют одну базу Valkey (db 0) с разными префиксами ключей. - Кэш не инвалидируется, если данные изменены напрямую в БД в обход API (в обычной работе это не происходит). - HTTP без TLS. Источники и использование ИИ: - материалы курса, OpenAPI-контракт и документация FastAPI, asyncpg, redis-py, PostgreSQL EXPLAIN, Docker Compose; ИИ использовался для пояснения требований задания, обсуждения архитектуры и проверки корректности реализации. Чек-лист: - Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - Контракт и публичные тесты не ослаблены. - Прямые проверки python tests/smoke.py, pytest student-tests/, python tests/resilience.py и EXPLAIN выполнены; результаты приведены в REPORT.md. - Сценарии отказов своего уровня воспроизведены. - Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - README задания сохранён, REPORT.md содержит инструкцию именно моего решения. Ссылка на файл [REPORT.md](./REPORT.md)
queenfish added 1 commit 2026-10-08 13:28:30 +03:00
Мессенджер с Postgres, Redis, Valkey
Skeleton contracts / contracts (pull_request) Failing after 37s
6bfbcf74fc
Owner

Прогретый кэш позволяет постороннему пользователю читать чужую историю — проверяйте членство до любого возврата из кэша.
Привяжите курсор к чату.
Неверный UUID должен давать 400, отказ зависимости — 503; сейчас возвращается 500.

Прогретый кэш позволяет постороннему пользователю читать чужую историю — проверяйте членство до любого возврата из кэша. Привяжите курсор к чату. Неверный UUID должен давать 400, отказ зависимости — 503; сейчас возвращается 500.
queenfish added 1 commit 2026-10-15 19:47:30 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:36 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#17