Files
mtusi2026lab2/REPORT.md
T
PoRATL ebd2e4a6a7 Добавить PostgreSQL и сессии для лабораторной 2.
Пароли хранятся как Argon2id, сессии переживают перезапуск базы.
2026-11-13 07:02:23 +03:00

69 lines
5.6 KiB
Markdown
Raw 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
- Автор, группа: Лобашов Валентин, БПИ2303
- Целевая оценка; выбранный трек 5, если нужен: 3
- Commit/PR: ветка solution/БПИ2303-lobashov, https://gitea.privcloud.tech/PoRATL/mtusi2026lab2
- Использованные источники, библиотеки и помощь ИИ: ASP.NET Core, Npgsql 9.0.4, Konscious.Security.Cryptography.Argon2 1.3.1, PostgreSQL 16.11, контракт репозитория. Реализацию и черновик отчёта подготовил ассистент Cursor.
## Запуск из чистого clone
Нужны Docker Desktop и интернет для первой сборки. Образы: `mcr.microsoft.com/dotnet/sdk:10.0.401`, `mcr.microsoft.com/dotnet/aspnet:10.0.12`, `postgres:16.11`.
```sh
copy .env.example .env
```
В `.env` замените `POSTGRES_PASSWORD` на локальный пароль. Файл не коммитится. Затем:
```sh
docker compose --env-file .env up -d --build
```
Миграция `src/Messenger/Migrations/001_init.sql` применяется при старте API и повторно ничего не создаёт. Готовность: `GET http://127.0.0.1:8080/health/ready` возвращает `{"status":"ok"}`.
```sh
python tests/smoke.py --base-url http://127.0.0.1:8080
dotnet test src/Messenger.slnx
```
Перезапуск API и PostgreSQL без удаления volume:
```sh
sh scripts/restart.sh
```
На Windows этот `.sh` напрямую не запускается. Та же команда: `docker compose --env-file .env restart postgres api`.
Остановка без удаления данных: `docker compose --env-file .env stop`. Удаление учебных данных: `docker compose --env-file .env down -v`.
## Архитектура и решения
Из lab1 перенесены пользователи, чаты, членство, сообщения, cursor и формат ошибок. Хранилище в памяти заменено на PostgreSQL. Redis не используется: для оценки 3 сессии лежат в PostgreSQL.
`SESSION_STORE=postgres`. `DATABASE_URL` задаёт Npgsql-строку внутри compose. `DATABASE_URL_FILE` из `.env.example` тоже читается, если переменной нет. `SESSION_TTL_SECONDS` по умолчанию 3600. `APP_HOST`, `APP_PORT`, `APP_ENV` те же, что в lab1.
Пароль хешируется Argon2id (память 19 МиБ, 2 итерации, parallelism 1). В ответе пользователя пароля нет. Токен сессии — 32 случайных байта. В базе хранится только SHA-256 токена, срок `expires_at` и `revoked_at`. Перезапуск срок не продлевает.
`POST /auth/sessions` принимает только Basic. Остальные защищённые маршруты принимают только Bearer. `X-User-Id` не даёт доступ и не подменяет сессию. Создание чата — одна транзакция: проверка участников, вставка чата и членства. Повторный username ловится уникальным ограничением и возвращает 409.
## Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | `python tests/smoke.py --base-url http://127.0.0.1:8080` | PASS | evidence/smoke.txt |
| Свои проверки входа, logout и пустого сообщения | `dotnet test src/Messenger.slnx` | 3 пройдено, 0 провалено | evidence/dotnet-test.txt |
| Рестарт API и PostgreSQL сохраняет сессию и сообщение | `docker compose --env-file .env restart postgres api`, затем тот же Bearer | PASS, 1.558 с, сообщение на месте | evidence/persistence.txt |
| Миграция при старте, логи без текста сообщений и пароля | `docker logs` контейнера API | migrations=True, утечек нет | evidence/logs.txt |
Проверялось 2026-11-13, Docker Desktop, compose-проект `2`.
## Эксперименты и отказы
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| `docker compose restart postgres api` | тот же токен читает те же данные, volume не стирается | `/health/ready` = 200, `/users/me` тот же пользователь, сообщение на месте | около 1.6 с; подтверждённые данные сохранены |
## Ограничения и следующие шаги
Оценка 3 не включает Redis/Valkey, EXPLAIN и отдельную проверку недоступности кэша. Если PostgreSQL не отвечает, `/health/ready` и запросы к данным возвращают 503. Два процесса API в этой работе не запускаются: одна база уже общая, но горизонтальное масштабирование — лабораторная 3. `scripts/restart.sh` рассчитан на `sh`; на Windows его выполняет `docker compose restart`.