# Отчёт — лабораторная 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`.