forked from mtusi2026/mtusi2026lab2
41 lines
3.1 KiB
Markdown
41 lines
3.1 KiB
Markdown
## Лабораторная 2
|
|
|
|
Автор / группа: Долда Кирилл, БПИ2301
|
|
Целевая оценка (3/4/5): 5
|
|
Трек 5, если заявлен: Трек 2 - План запроса и восстановление
|
|
|
|
## Что реализовано и что перенесено:
|
|
* Реализован REST API мессенджера с хранением в PostgreSQL и сессиями в Redis.
|
|
* Перенесено из lab1: эндпоинты пользователей, чатов и сообщений, формат ошибок Error, X-Request-Id, пагинация, healthcheck, Dockerfile с непривилегированным пользователем и graceful shutdown.
|
|
* Изменено: X-User-Id заменён на Bearer-токены (Basic только на /auth/sessions), хранилище переведено с in-memory словарей на PostgreSQL, добавлены миграции Alembic, хеширование паролей bcrypt, Redis для сессий с TTL и AOF, собственные тесты безопасности.
|
|
|
|
## Команды запуска из чистого clone:
|
|
* cp .env.example .env
|
|
* docker compose up -d --build
|
|
* docker exec -it -u root -w /app mtusi_messenger_app alembic revision --autogenerate -m "create tables"
|
|
* docker exec -it -w /app mtusi_messenger_app alembic upgrade head
|
|
* make test
|
|
* pytest tests/test_security.py -v
|
|
* make explain-10k
|
|
* make explain-composite
|
|
* make explain-simple
|
|
* make backup-restore
|
|
|
|
## Результаты проверок и ссылка на REPORT.md:
|
|
make test — PASS: lab2 public API scenario.
|
|
pytest tests/test_security.py -v — 3/3 PASS.
|
|
make explain-10k — Index Scan, 0.22 мс.
|
|
Сравнение индексов на 80 000: составной 0.308 мс без сортировки, простой 8.200 мс, разница в 27 раз.
|
|
make backup-restore — 200 008 записей в основной и восстановленной базах, целостность подтверждена.
|
|
Выводы сохранены в evidence/ (explain_10k.txt, explain_composite.txt, explain_simple.txt, backup.sql)
|
|
|
|
## Источники и использование ИИ:
|
|
FastAPI, SQLAlchemy, asyncpg, Alembic, passlib[bcrypt], redis, psycopg2-binary, pytest. ИИ — помощь в разборе контракта.
|
|
|
|
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
|
- [ ] Контракт и публичные тесты не ослаблены.
|
|
- [ ] make check и make test выполнены; приложен реальный вывод.
|
|
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
|
|
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
|
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|