42 lines
4.4 KiB
Markdown
42 lines
4.4 KiB
Markdown
## Лабораторная 2
|
|
|
|
Автор / группа: Заморский Павел, БВТ2302
|
|
Целевая оценка (3/4/5): 5
|
|
Трек 5, если заявлен: Трек 2 (План запроса на ≥100 000 сообщениях с неравномерными размерами чатов и backup/restore) + Трек 1 (Согласованность кэша, защита от cache stampede и read-after-write)
|
|
|
|
Что реализовано и что перенесено:
|
|
- Перенесён HTTP API из ЛР1 (`cmd/server`, `internal/handler`, `internal/model`) с переводом хранения на PostgreSQL 18 (`postgres:18-alpine`, `pgx/v5`, пул соединений `pgxpool`, транзакции и таймауты) и кэшированием/хранением сессий в Redis 7.4 (`redis:7.4-alpine` с персистентностью AOF `appendfsync everysec`).
|
|
- Добавлены версионируемые идемпотентные SQL-миграции (`migrations/001_init.sql` + таблица `schema_migrations`).
|
|
- Реализована регистрация с хешированием паролей через **Argon2id** (`golang.org/x/crypto/argon2`, параметры `m=19456, t=1, p=2`), вход через `POST /api/v1/auth/sessions` (`Authorization: Basic <base64(username:password)>` с поддержкой двоеточий в пароле и защитой от timing-атак), выдача криптостойких 256-битных opaque Bearer-токенов (хранятся в виде SHA-256 дайджестов) и отзыв сессии через `DELETE /api/v1/auth/sessions/current`.
|
|
- Подготовлен `compose.yaml` с именованными volumes (`mtusi_lab2_pgdata`, `mtusi_lab2_redisdata`), проверками `healthcheck` и скриптом полного перезапуска `scripts/restart.sh`.
|
|
|
|
Команды запуска из чистого clone:
|
|
```sh
|
|
cp .env.example .env
|
|
docker compose --env-file .env config --quiet
|
|
docker compose --env-file .env up -d --build
|
|
make check
|
|
make test
|
|
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
|
make test-grade4
|
|
make test-track1
|
|
make test-track2
|
|
```
|
|
|
|
Результаты проверок и ссылка на REPORT.md:
|
|
- Все публичные (`make check`, `make test`, `make test-persistence`) и дополнительные (`make test-grade4`, `make test-track1`, `make test-track2`) проверки проходят со статусом `PASS`. Подробный разбор, планы `EXPLAIN (ANALYZE, BUFFERS)` и метрики приведены в [REPORT.md](../REPORT.md) и директории `evidence/`.
|
|
|
|
Ограничения / известные ошибки:
|
|
- API работает в одной реплике (горизонтальное масштабирование за балансировщиком и `Idempotency-Key` предусмотрены в ЛР3).
|
|
- При полном отказе PostgreSQL сервис ожидаемо возвращает `503 unavailable` (так как PostgreSQL является единственным источником истины), а при отказе Redis прозрачно переходит на чтение из PostgreSQL.
|
|
|
|
Источники и использование ИИ:
|
|
- Документация PostgreSQL 18 (Transactions, EXPLAIN, B-Tree indexes), RFC 7617 (HTTP Basic Auth), OWASP Password Storage Cheat Sheet (Argon2id), документация пакетов `jackc/pgx/v5` и `redis/go-redis/v9`. Помощь ИИ (Google Antigravity) при генерации шаблонов тестов, нагрузочных скриптов и оформлении отчёта.
|
|
|
|
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
|
- [x] Контракт и публичные тесты не ослаблены.
|
|
- [x] make check и make test выполнены; приложен реальный вывод.
|
|
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
|
|
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
|
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|