forked from mtusi2026/mtusi2026lab2
69 lines
5.6 KiB
Markdown
69 lines
5.6 KiB
Markdown
# Отчёт — лабораторная 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`.
|