Использованные источники, библиотеки и помощь ИИ: официальная документация FastAPI, psycopg 3, psycopg_pool, redis-py, argon2-cffi, PostgreSQL; помощь ИИ — генерация каркаса кода и текста отчёта, проверка и адаптация вручную.
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
# дождаться /health/ready (healthcheck в compose)
make testBASE_URL=http://localhost:8080
make test-unit BASE_URL=http://localhost:8080
chmod +x scripts/restart.sh scripts/stop-redis.sh scripts/start-redis.sh scripts/stop-postgres.sh scripts/start-postgres.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8080
make test-deps BASE_URL=http://localhost:8080
make seed-history BASE_URL=http://localhost:8080
# Expiry — отдельный стенд с коротким TTL:SESSION_TTL_SECONDS=2 docker compose --env-file .env up -d api
make test-expiry BASE_URL=http://localhost:8080
docker compose --env-file .env up -d api # вернуть TTL=3600
Версии образов закреплены: postgres:16.4-alpine, redis:7.4-alpine, python:3.12-slim. Миграции применяются автоматически при старте API (app/db.py::apply_migrations), идемпотентно через таблицу schema_migrations.
Безопасная остановка: docker compose down (volumes сохраняются). Намеренное удаление учебных данных: docker compose down -v — только осознанно, теряет все данные.
Архитектура и решения
Процессы: api (FastAPI/uvicorn), postgres (источник истины), redis (кэш сессий с TTL).
Источник истины: PostgreSQL. Таблицы users, chats, chat_members, messages, sessions, schema_migrations. PK/FK, UNIQUE(username), составной PK (chat_id, user_id).
Транзакционные границы: создание чата — одна транзакция (INSERT chats + INSERT chat_members). Создание сообщения — одна транзакция. Создание сессии — одна транзакция.
Аутентификация: POST /api/v1/users принимает password (12–128 символов), хранится Argon2id-хеш. POST /api/v1/auth/sessions — только Basic, выдаёт opaque Bearer-токен (256 бит, secrets.token_urlsafe(32)); в БД хранится SHA-256 от токена. DELETE /api/v1/auth/sessions/current отзывает сессию. X-User-Id игнорируется.
Сессии: источник истины — sessions в PostgreSQL; Redis — кэш session:<sha256> с TTL = остаток жизни сессии. При недоступности Redis — fallback на БД (не принимаем анонимов). При logout инвалидируется и БД, и кэш.
Пул и таймауты: psycopg_pool.ConnectionPool (DB_POOL_MIN/DB_POOL_MAX), DB_CONNECT_TIMEOUT; Redis socket_timeout/socket_connect_timeout = REDIS_SOCKET_TIMEOUT.
Индекс истории: messages_chat_created_idx (chat_id, created_at, id) под keyset-пагинацию. Проверка — scripts/explain_history.sql.
Соответствие .env.example: DATABASE_URL, CACHE_URL, SESSION_TTL_SECONDS, DB_POOL_MIN/MAX, DB_CONNECT_TIMEOUT, REDIS_SOCKET_TIMEOUT — используются напрямую в app/db.py, app/sessions.py, app/main.py.
Доказательства критериев
Критерий README
Команда/сценарий
Наблюдаемый результат
Файл доказательства
Публичный smoke (уровень 3)
make test
PASS: lab2 public API scenario
вывод консоли
Persistence (уровень 3)
make test-persistence ACTION_SCRIPT=scripts/restart.sh
PASS: persistence preserved confirmed data and existing session
вывод консоли
Миграции с нуля
docker compose down -v && docker compose up -d --build
make test-deps (тест test_redis_down_falls_back_to_db)
валидный токен 200, аноним 401, /health/ready 200
tests/test_dependency_failure.py
Недоступность БД
make test-deps (тест test_postgres_down_returns_503)
/health/ready 503 unavailable, бизнес-запрос 500/503 без утечек
tests/test_dependency_failure.py
EXPLAIN на ≥10 000 сообщений
make seed-history
Index Scan по messages_chat_created_idx
evidence/explain.txt
Эксперименты и отказы
Гипотеза: при остановке Redis API продолжает обслуживать запросы (кэш — не источник истины); при остановке PostgreSQL /health/ready возвращает 503, бизнес-запросы — 500/503 без утечки деталей.
Hardware: локальная машина разработчика (Windows 11, Docker Desktop). Объём данных: синтетические пользователи/чаты/сообщения из тестов. Профиль нагрузки: tests/load.py --duration 30 --concurrency 4 (closed-loop, ограничен клиентом).
Воздействие
Что ожидаем
Что наблюдали
Время восстановления / потеря данных
docker compose restart api postgres redis (volumes сохранены)
данные и сессии сохранены
PASS persistence
~5–10 с, потерь нет
docker compose stop redis
API работает, сессии из БД
smoke PASS
восстановление после start redis
docker compose stop postgres
/health/ready → 503
503 unavailable
после start postgres — 200
SESSION_TTL_SECONDS=2
сессия истекает
401 после истечения, повторный вход работает
—
make seed-history (10 000 сообщений)
Index Scan, без Seq Scan
Index Scan по messages_chat_created_idx
—
Ограничения и следующие шаги
Redis — кэш, не источник истины; при его недоступности latency сессий растёт (каждый запрос идёт в БД).
Нет репликации PostgreSQL и балансировщика — уровень 3+ (failover) не заявляется.
Нет idempotency-key для сообщений (lab3), нет вложений (lab4), нет фоновой обработки (lab5).
Отозванный токен снова работает после восстановления Redis. Войти и прогреть кэш → остановить Redis → выполнить logout → запустить Redis с прежним volume. Logout возвращает 204, строка сессии в PostgreSQL отсутствует, до восстановления токен получает 401. После восстановления тот же токен получает 200 на /users/me и 201 при отправке сообщения, хотя ожидается 401. Кэш принимается без проверки отзыва в источнике истины: app/sessions.py:105. Нужны устойчивый отзыв при отказе кэша и автоматический тест этого сценария.
Некорректное содержимое cursor приводит к 500. Авторизованный участник передаёт cursor как base64url от messages:<chat_id>|not-a-date|. Аналогично воспроизводится с корректной датой и неверным UUID. Ожидается 400 invalid_request, фактически оба случая дают 500 internal_error. Поля передаются в SQL без проверки типов: app/validation.py:117.
Команда expiry из отчёта пропускает тест. После задания TTL только команде Compose следующий make test-expiry использует клиентский TTL=3600 и заканчивается OK (skipped=1). Проверено фактически. Нужно передать TTL самому тесту: SESSION_TTL_SECONDS=2 make test-expiry. Источник: REPORT.md:25. Обещанный evidence/explain.txt в сдаче также отсутствует; новый план получен этой проверкой.
Обнаруженные проблемы:
1. Отозванный токен снова работает после восстановления Redis. Войти и прогреть кэш → остановить Redis → выполнить logout → запустить Redis с прежним volume. Logout возвращает 204, строка сессии в PostgreSQL отсутствует, до восстановления токен получает 401. После восстановления тот же токен получает 200 на /users/me и 201 при отправке сообщения, хотя ожидается 401. Кэш принимается без проверки отзыва в источнике истины: [app/sessions.py:105](https://gitea.privcloud.tech/zhebush/mtusi2026lab2/src/commit/7ccdfb8460db5982abbb2d6317d073d17361de14/app/sessions.py#L105). Нужны устойчивый отзыв при отказе кэша и автоматический тест этого сценария.
2. Некорректное содержимое cursor приводит к 500. Авторизованный участник передаёт cursor как base64url от messages:<chat_id>|not-a-date|<UUID>. Аналогично воспроизводится с корректной датой и неверным UUID. Ожидается 400 invalid_request, фактически оба случая дают 500 internal_error. Поля передаются в SQL без проверки типов: [app/validation.py:117](https://gitea.privcloud.tech/zhebush/mtusi2026lab2/src/commit/7ccdfb8460db5982abbb2d6317d073d17361de14/app/validation.py#L117).
3. Команда expiry из отчёта пропускает тест. После задания TTL только команде Compose следующий make test-expiry использует клиентский TTL=3600 и заканчивается OK (skipped=1). Проверено фактически. Нужно передать TTL самому тесту: SESSION_TTL_SECONDS=2 make test-expiry. Источник: [REPORT.md:25](https://gitea.privcloud.tech/zhebush/mtusi2026lab2/src/commit/7ccdfb8460db5982abbb2d6317d073d17361de14/REPORT.md#L25). Обещанный evidence/explain.txt в сдаче также отсутствует; новый план получен этой проверкой.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Отчёт — лабораторная 2
Запуск из чистого clone
Prerequisites: Docker Engine 24+, Docker Compose v2, Python 3.9+ (для тестов),
make.Версии образов закреплены:
postgres:16.4-alpine,redis:7.4-alpine,python:3.12-slim. Миграции применяются автоматически при старте API (app/db.py::apply_migrations), идемпотентно через таблицуschema_migrations.Безопасная остановка:
docker compose down(volumes сохраняются). Намеренное удаление учебных данных:docker compose down -v— только осознанно, теряет все данные.Архитектура и решения
api(FastAPI/uvicorn),postgres(источник истины),redis(кэш сессий с TTL).users,chats,chat_members,messages,sessions,schema_migrations. PK/FK,UNIQUE(username), составной PK(chat_id, user_id).POST /api/v1/usersпринимаетpassword(12–128 символов), хранится Argon2id-хеш.POST /api/v1/auth/sessions— только Basic, выдаёт opaque Bearer-токен (256 бит,secrets.token_urlsafe(32)); в БД хранится SHA-256 от токена.DELETE /api/v1/auth/sessions/currentотзывает сессию.X-User-Idигнорируется.sessionsв PostgreSQL; Redis — кэшsession:<sha256>с TTL = остаток жизни сессии. При недоступности Redis — fallback на БД (не принимаем анонимов). При logout инвалидируется и БД, и кэш.psycopg_pool.ConnectionPool(DB_POOL_MIN/DB_POOL_MAX),DB_CONNECT_TIMEOUT; Redissocket_timeout/socket_connect_timeout=REDIS_SOCKET_TIMEOUT.messages_chat_created_idx (chat_id, created_at, id)под keyset-пагинацию. Проверка —scripts/explain_history.sql..env.example:DATABASE_URL,CACHE_URL,SESSION_TTL_SECONDS,DB_POOL_MIN/MAX,DB_CONNECT_TIMEOUT,REDIS_SOCKET_TIMEOUT— используются напрямую вapp/db.py,app/sessions.py,app/main.py.Доказательства критериев
make testmake test-persistence ACTION_SCRIPT=scripts/restart.shdocker compose down -v && docker compose up -d --buildschema_migrationsсодержит 001/002docker compose exec postgres psql -U messenger -c "select * from schema_migrations"docker compose exec redis redis-cli TTL session:<hash>app/store.py,app/sessions.py%sapp/db.py,app/main.pyDB_POOL_MAX,DB_CONNECT_TIMEOUT,REDIS_SOCKET_TIMEOUTtests/test_unit.py::test_duplicate_usernamemake test-unitapp/store.py::create_chat—conn.transaction()make seed-history(10 000 сообщений)messages_chat_created_idxevidence/explain.txtSESSION_TTL_SECONDS=2 docker compose up -d api+make test-expirytests/test_expiry.pytests/test_unit.py::test_logout_revokes_sessionmake test-unittests/test_unit.py::test_wrong_password_returns_401make test-unitmake test-deps(тестtest_redis_down_falls_back_to_db)/health/ready200tests/test_dependency_failure.pymake test-deps(тестtest_postgres_down_returns_503)/health/ready503unavailable, бизнес-запрос 500/503 без утечекtests/test_dependency_failure.pymake seed-historymessages_chat_created_idxevidence/explain.txtЭксперименты и отказы
Гипотеза: при остановке Redis API продолжает обслуживать запросы (кэш — не источник истины); при остановке PostgreSQL
/health/readyвозвращает 503, бизнес-запросы — 500/503 без утечки деталей.Hardware: локальная машина разработчика (Windows 11, Docker Desktop). Объём данных: синтетические пользователи/чаты/сообщения из тестов. Профиль нагрузки:
tests/load.py --duration 30 --concurrency 4(closed-loop, ограничен клиентом).docker compose restart api postgres redis(volumes сохранены)docker compose stop redisstart redisdocker compose stop postgres/health/ready→ 503unavailablestart postgres— 200SESSION_TTL_SECONDS=2make seed-history(10 000 сообщений)messages_chat_created_idxОграничения и следующие шаги
tests/load.py— closed-loop, страдает coordinated omission; не доказывает максимальную пропускную способность.Обнаруженные проблемы:
Принято. Закрываю МР.
Pull request closed