forked from mtusi2026/mtusi2026lab2
3.3 KiB
3.3 KiB
Отчёт — лабораторная 2
- Автор, группа: Евпраксина Эльвира БПИ2304
- Целевая оценка; 3
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: FastAPI, PostgreSQL, Argon2id, Docker Compose.
Запуск из чистого clone
- Создать файлы секретов в папке
secrets:pg_password.txt(случайный пароль).database_url.txt(postgresql://messenger:ПАРОЛЬ@postgres:5432/messenger). Оба файла должны быть в кодировке UTF-8 (без BOM).
- Запуск:
docker compose up -d --build - Дождаться статуса
healthyу контейнеров (docker compose ps). - Тест API:
python tests\smoke.py --base-url http://localhost:8080 - Тест сохранности:
python tests\resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080 - Остановка:
docker compose down. Удаление данных:docker compose down -v.
Архитектура и решения
- API: Python 3.12, FastAPI, Uvicorn.
- БД: PostgreSQL 16.4. Таблицы: users, chats, chat_members, messages, sessions. Настроены PK, FK и каскадное удаление.
- Аутентификация: Пароли хешируются с помощью Argon2id (
argon2-cffi). Сессии хранятся в PostgreSQL (opaque Bearer токен, TTL 3600 секунд). - Пагинация: Keyset cursor на основе
(created_at, id). Запрашиваетсяlimit + 1запись для проверки наличия следующей страницы. - Изменения с lab1: Добавлен
passwordпри регистрации, вход черезBasic, защищенные методы черезBearerвместоX-User-Id. - Переменные:
DATABASE_URL_FILEуказывает на файл с паролем (Docker secrets).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | python tests\smoke.py --base-url http://localhost:8080 |
PASS: lab2 public API scenario | Скриншот терминала |
| Сохранность данных | python tests\resilience.py --mode persistence --action-script scripts/restart.bat ... |
PASS: persistence preserved confirmed data | Скриншот терминала |
| Таблицы и ключи | migrations/001_init.sql |
Созданы таблицы с FK и ограничениями | Файл миграции |
| Безопасность сессий | Тест в smoke.py |
401 Unauthorized при неверном пароле и отзыве | Логи API |
Ограничения и следующие шаги
- Приложение запускается в единственном экземпляре, балансировка нагрузки не реализована (требуется на оценку 4).
- Redis/Valkey не используется, сессии хранятся в PostgreSQL.