5.9 KiB
Отчёт — лабораторная 2
- Автор, группа: Матвиенко Павел, БПИ2304
- Целевая оценка: 3
- Commit/PR:
- Использованные источники и библиотеки:
contracts/openapi.json,contracts/README.md, Python 3.12, FastAPI 0.115.12, Uvicorn 0.34.2, PostgreSQL 16, psycopg 3.2.6, argon2-cffi 23.1.0, Docker Compose.
Запуск из чистого clone
Для запуска необходимы Git, Docker Desktop, Python 3 и WSL Ubuntu с Make.
Создать файл .env в корне проекта:
POSTGRES_PASSWORD=<случайный_пароль>
SESSION_TTL_SECONDS=3600
Сборка и запуск:
docker compose up -d --build
docker compose ps
curl http://127.0.0.1:8080/health/ready
Миграции автоматически выполняются при запуске API. Повторная проверка:
docker compose exec -T api python -m src.migrate
Запуск тестов:
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Остановка с сохранением данных:
docker compose down
Полное удаление учебных данных вместе с volume:
docker compose down -v
Архитектура и решения
Архитектура: Клиент → FastAPI → PostgreSQL.
В Docker Compose работают два сервиса: api и db. PostgreSQL является основным хранилищем. Данные сохраняются в именованном volume postgres_data.
Созданы таблицы users, chats, chat_members, messages, sessions, schema_migrations. Используются первичные и внешние ключи, ограничения уникальности и индексы.
Пароли хешируются с помощью Argon2. Вход выполняется через Basic, после чего выдаётся Bearer-токен со сроком действия. Сессии сохраняются в PostgreSQL, поддерживается logout.
Создание чата и добавление участников выполняются в одной транзакции. История сообщений использует пагинацию по (created_at, id).
Из lab1 перенесены пользователи, чаты и сообщения. Вместо хранения в памяти используется PostgreSQL, а X-User-Id заменён на Basic/Bearer.
Настройки POSTGRES_PASSWORD и SESSION_TTL_SECONDS задаются через .env. Строка подключения DATABASE_URL формируется в compose.yaml.
Доказательства критериев
| Критерий | Команда | Результат | Доказательство |
|---|---|---|---|
| Публичный smoke | python3 tests/smoke.py --base-url http://127.0.0.1:8080 |
PASS | evidence/smoke.txt |
| Сохранение данных и сессий | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS | evidence/persistence.txt |
| Работа контейнеров | docker compose ps |
API и PostgreSQL healthy | evidence/containers.txt |
| Повторные миграции | docker compose exec -T api python -m src.migrate |
Already applied: 001_initial.sql | evidence/migrations.txt |
| Перезапуск инфраструктуры | bash scripts/restart.sh |
Оба сервиса перезапущены и healthy | evidence/restart-times.txt, evidence/containers-after-restart.txt |
Уровень 4 и трек 5 не заявлены.
Эксперименты и отказы
Гипотеза: после перезапуска API и PostgreSQL с сохранением volume сообщения и действующие сессии не теряются.
Среда: Windows, WSL Ubuntu, Docker Desktop, Python 3.12, PostgreSQL 16.
Проведён тест make test-persistence ACTION_SCRIPT=scripts/restart.sh. Скрипт остановил API, перезапустил PostgreSQL и повторно запустил API.
Результат:
PASS: persistence preserved confirmed data and existing session.
Также проверен повторный запуск миграций:
Already applied: 001_initial.sql
Migrations completed
| Воздействие | Ожидание | Результат | Потеря данных |
|---|---|---|---|
| Перезапуск API и PostgreSQL | Данные и сессии сохраняются | PASS | Не обнаружена |
| Повторный запуск миграций | Нет повторного применения | Успешно | Не обнаружена |
Проверки проводились на небольшом объёме тестовых данных. Нагрузочные измерения RPS, p50/p95/p99 и CPU/RAM не выполнялись.
Ограничения и следующие шаги
Приложение использует один экземпляр PostgreSQL без резервирования. При удалении volume данные теряются. Redis/Valkey и балансировка нагрузки не реализованы, так как не требуются для оценки 3.
В дальнейшем можно добавить резервное копирование, пул соединений и мониторинг.
Вывод: API работает с PostgreSQL, поддерживает регистрацию и Bearer-сессии. Публичный smoke и тест сохранности данных после перезапуска успешно пройдены.