Files
mtusi2026lab2/REPORT.md

60 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ЛР2 — PostgreSQL и сессии
Кузнецов Даниил Русланович, БПИ2304. На **3**.
## Запуск
Нужны Python 3.13, Git и Docker с Compose. Из папки репозитория:
```powershell
python -X utf8 scripts/lab.py verify
```
Создаются `.venv`, локальный `.env` и новые секреты. Скрипт собирает образ,
применяет миграции, запускает API и проверки. Повторный setup сохраняет настройки.
API: `http://127.0.0.1:18102`, Compose-проект: `kuznetsov-lab2`.
Linux: те же команды через `python3`.
Отдельно доступны `setup`, `build`, `start`, `test`, `restart-check`, `stop`.
Например: `python -X utf8 scripts/lab.py stop`. Остановка сохраняет volume.
Намеренный сброс учебной БД: `docker compose -p kuznetsov-lab2 --env-file .env down --volumes`.
## Реализация
FastAPI → PostgreSQL. В БД хранятся пользователи, чаты, участники, сообщения и сессии.
Чат и участники создаются одной транзакцией; история выбирается SQL-пагинацией
по `(created_at, id)`, курсоры подписываются постоянным ключом.
Регистрация требует пароль; в БД только Argon2id-хеш. Basic используется при входе,
дальше Bearer. Хранится SHA-256 токена, TTL — 3600 секунд; logout удаляет сессию.
SQL параметризован, пул и запросы имеют таймауты. Миграции нумеруются и проверяют checksum.
Python 3.13.14, PostgreSQL 17.11, Psycopg 3.3.8.
Образы и зависимости закреплены. API работает без root, наружу открыт только его порт,
БД и секреты доступны внутри стенда.
## Проверки
Команда: `python -X utf8 scripts/lab.py verify`.
| Проверка | Результат |
| --- | --- |
| Структура, OpenAPI, Compose, публичный smoke | PASS — [лог](evidence/verification.txt) |
| Пароли, доступ, Unicode, пагинация, конкуренция | 17 тестов, PASS — [лог](evidence/verification.txt) |
| Рестарт API/БД: старые токен, курсор, сообщения и logout | PASS — [данные](evidence/persistence.json), [контейнеры](evidence/restart.json) |
| Повторные миграции | Данные не изменились — [JSON](evidence/persistence.json) |
| TTL=2 на отдельном порту 18112 | Истёкший токен 401, expiry не продлевается — [JSON](evidence/expiry.json) |
| Остановка БД и восстановление | live 200, ready/API 503, затем 200 — [сводка](evidence/summary.json) |
Чистый клон коммита `8e06e7634f6082866d8ac4204106453490c103cf` прошёл полный прогон:
`python -X utf8 scripts/lab.py verify --project kuznetsov-lab2-clean --port 18122 --test-port 18132`.
Использованы новые секреты и volume. [Лог](evidence/clean-clone-verification.txt),
[сводка](evidence/clean-clone-summary.json).
TTL-стенд удаляет только свои временные контейнеры и сети, сохраняя volume.
Ограничения: локальный HTTP, одна API-реплика и одна БД, без Redis и HA.
Основа — [реализация Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab2/src/commit/2ae42b5ef61fe05695c9a28224599109454bde9d).
Для Даниила выделены свои настройки, секреты, ports/volumes и проверки.
README задания, контракт и публичные тесты сохранены.