5.6 KiB
Отчёт — лабораторная 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.
copy .env.example .env
В .env замените POSTGRES_PASSWORD на локальный пароль. Файл не коммитится. Затем:
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"}.
python tests/smoke.py --base-url http://127.0.0.1:8080
dotnet test src/Messenger.slnx
Перезапуск API и PostgreSQL без удаления volume:
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.