4.4 KiB
Отчёт — лабораторная 2
- Автор, группа: TODO
- Целевая оценка: 3
- Commit/PR: TODO после публикации
- Использованные библиотеки: FastAPI 0.141.1, Uvicorn 0.40.0, asyncpg 0.31.0, argon2-cffi 25.1.0; зафиксированы в
pyproject.tomlиuv.lock.
Запуск из чистого clone
Нужны Docker Engine с Docker Compose v2 и OpenSSL. Создайте только локальные секреты — они исключены из Git:
mkdir -p secrets
openssl rand -hex 32 -out secrets/postgres_password
awk '{printf "postgresql://messenger:%s@postgres:5432/messenger\\n", $0}' \
secrets/postgres_password > secrets/database_url
chmod 700 secrets
chmod 600 secrets/postgres_password secrets/database_url
docker compose --env-file .env.example config --quiet
docker compose --env-file .env.example up -d --build
API публикуется на http://localhost:8080. Миграции запускаются API при
старте; таблица schema_migrations не применяет уже записанную миграцию
повторно. Проверка готовности:
curl -fsS http://localhost:8080/health/ready
make test
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Обычная остановка сохраняет учебные данные:
docker compose down
Намеренно удалить учебные данные можно только отдельной командой
docker compose down -v; она не входит в restart hook.
Архитектура и решения
HTTP-клиент → FastAPI API → asyncpg pool (1..10 соединений) → PostgreSQL
└→ миграции SQL при старте
PostgreSQL — источник истины для users, chats, chat_members,
messages и sessions. Named volume postgres_data хранит каталог БД.
Токен сессии создаётся через secrets.token_urlsafe(32); в БД лежит только
SHA-256 токена и время истечения. Пароли хешируются Argon2 через
argon2-cffi; plaintext и hash не попадают в API-ответы.
POST /api/v1/users требует password. POST /api/v1/auth/sessions
принимает только Basic и выдаёт opaque Bearer token. Все бизнес-endpoint
определяют пользователя только по Bearer; X-User-Id игнорируется.
Logout удаляет текущую серверную сессию. Срок действия фиксируется при
создании и задаётся SESSION_TTL_SECONDS (3600 по умолчанию).
Создание чата — одна транзакция: проверка состава пользователей, запись чата и
всех участников. Внешние ключи и уникальность username заданы миграцией.
История выбирается keyset-запросом по (created_at, id); индекс
messages_chat_created_id_idx соответствует этому запросу.
Доказательства критериев
| Критерий | Команда | Наблюдаемый результат | Статус |
|---|---|---|---|
| Контракт и синтаксис | make check |
PASS | выполнено |
| Импорт приложения и Basic parser | uv run --frozen python … |
PASS | выполнено |
| Согласованность lock-файла | uv lock --check |
PASS | выполнено |
| Публичный smoke | make test |
PASS: lab2 public API scenario |
evidence/smoke-2026-10-08.txt |
| Persistence | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS: persistence preserved confirmed data and existing session |
evidence/persistence-2026-10-08.txt |
Ограничения и следующие шаги
Redis/Valkey не используется: он относится к уровню 4 этой лабораторной.
Публичные smoke и persistence выполнены на локальном Compose-стенде 2026-10-08.
При фиксации работы в PR сохраните их stdout в evidence/ без токенов и
паролей.