Files
mtusi2026lab2/REPORT.md
T
daniil_sobolev 873eff9a3f
Skeleton contracts / contracts (pull_request) Failing after 41s
report
2026-10-29 01:32:09 +03:00

6.3 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: Соболев Даниил Романович, БПИ2302
  • Целевая оценка; выбранный трек 5, если нужен: 4
  • Commit/PR: 3c5af42f24
  • Использованные источники, библиотеки и помощь ИИ: FastAPI, Uvicorn, Pydantic, psycopg3+pool, redis-py, argon2-cffi; контракт курса; помощь ИИ при переносе на PostgreSQL/сессии/Redis

Запуск из чистого clone

Prerequisites: Docker / Docker Compose; Python 3.9+ для make test / make test-own (stdlib).

cp .env.example .env
# Windows:
powershell -File scripts/make_secrets.ps1
# Unix:
# sh scripts/make_secrets.sh

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build

Ожидание готовности: GET http://localhost:8080/health/ready → {"status":"ok"} (миграции применяются при старте API).

make test
# Windows: py -3 tests\smoke.py --base-url http://localhost:8080
make test-own
# Unix / Git Bash:
# chmod +x scripts/restart.sh && make test-persistence ACTION_SCRIPT=scripts/restart.sh
# Windows (cmd):
py -3 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:8080

Проверка expiry (отдельный прогон с коротким TTL):

# SESSION_TTL_SECONDS=5 в env-файле, затем recreate api и:
# SESSION_TTL_SECONDS=5 py -3 tests\own.py
# или: py -3 scripts\test_expiry_raw.py

EXPLAIN индекса истории (≥10 000 сообщений):

# из secrets/database_url заменить хост postgres → 127.0.0.1
set DATABASE_URL=postgresql://messenger:PASSWORD@127.0.0.1:15432/messenger
set CACHE_URL=redis://127.0.0.1:6379/0
py -3 scripts/explain_messages.py
# результат: evidence/explain.txt

Безопасная остановка (volumes сохраняются):

docker compose --env-file .env stop
# или down без -v
docker compose --env-file .env down

Намеренное удаление учебных данных:

docker compose --env-file .env down -v

Версии: python:3.12.7-slim-bookworm, postgres:16.4-bookworm, redis:7.4.1-bookworm; зависимости в requirements.txt.

Архитектура и решения

Клиент → API (FastAPI) → PostgreSQL (источник истины: users/chats/members/messages)
                       → Redis (opaque Bearer-сессии, TTL + AOF everysec)
  • Перенос из lab1: контракт users/chats/messages, keyset-cursor, формат ошибок, non-root Dockerfile, X-Request-Id.
  • Изменения lab2: password + Argon2id; POST /auth/sessions (Basic); Bearer вместо X-User-Id; сессии в Redis.
  • Источник истины данных: PostgreSQL. Сессии — Redis (единственное хранилище сессий) с AOF, чтобы переживать compose restart.
  • Транзакции: создание чата = INSERT chats + INSERT chat_members в одной транзакции; при неизвестном участнике — rollback.
  • Пул/таймауты: psycopg_pool.ConnectionPool (min/max), connect_timeout; Redis socket_connect_timeout / socket_timeout.
  • Индекс истории: messages (chat_id, created_at, id) под keyset WHERE chat_id=$1 AND (created_at,id)>($2,$3) ORDER BY created_at,id LIMIT n.
  • Ready: live = процесс; ready = accepting + ping Postgres + ping Redis.
  • Конфиг: .env + secret-файлы DATABASE_URL_FILE / CACHE_URL_FILE (см. .env.example).

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke make test PASS: lab2 public API scenario evidence/smoke.txt
Persistence + сессия make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: token и сообщение после restart evidence/persistence.txt
Собственные тесты 4 make test-own wrong password, logout, race username, concurrency, redis-down evidence/own.txt
Expiry короткого TTL SESSION_TTL_SECONDS=2 + make test-own 401 после TTL evidence/own.txt
EXPLAIN ≥10k scripts/explain_messages.py Index Scan по messages_chat_created_id_idx evidence/explain.txt
Миграции идемпотентны повторный up / restart API без дублей schema_migrations логи API

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
scripts/restart.sh (API+Postgres+Redis, volumes) те же данные и Bearer persistence PASS до готовности ≤90 с; без потери при сохранённых volumes
docker compose stop redis ready 503; нет анонимного доступа own redis-down PASS после start redis ready снова ok
Гонка 8× одинаковый username 1×201 + 7×409 own username race PASS без дублей username
10×10 POST сообщений 100 уникальных own concurrency PASS без потери подтверждённых

Ограничения измерения: closed-loop smoke/own на localhost; tests/load.py — throughput HTTP-подтверждений, не точный счётчик COMMIT.

Ограничения и следующие шаги

  • Один Docker-host: нет HA Postgres/Redis/API.
  • Сессии только в Redis: flush/AOF-сбой без Postgres-backup сессий = повторный login (данные чатов в PG сохраняются).
  • Нет lab3 LB/идемпотентности, вложений, TLS.
  • Следующий шаг курса: горизонтальное масштабирование и общий session store.