forked from mtusi2026/mtusi2026lab2
60 lines
4.0 KiB
Markdown
60 lines
4.0 KiB
Markdown
# ЛР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 задания, контракт и публичные тесты сохранены.
|