5.0 KiB
Запуск из чистого clone
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
curl http://localhost:8080/health/ready
make test
make test-grade4
Для повторной проверки сохранности:
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Для остановки без удаления данных:
docker compose --env-file .env down
Намеренное удаление учебных данных выполняется отдельно и осознанно командой docker compose down -v.
Архитектура и решения
Spring Boot API работает от имени непривилегированного пользователя 10001. PostgreSQL является источником истины для таблиц users, chats, chat_members и messages. Flyway применяет версионируемую миграцию V1__messenger.sql при старте. Создание чата и участников выполняется одной @Transactional операцией; уникальность username дополнительно гарантируется ограничением PostgreSQL.
Пароль при регистрации не возвращается и хранится как SCrypt-хеш. POST /api/v1/auth/sessions принимает только Basic username:password, создаёт случайный 256-битный opaque Bearer-токен и сохраняет его в Redis с TTL SESSION_TTL_SECONDS. Redis включён с AOF и named volume, поэтому действующие сессии переживают проверяемый рестарт. Logout удаляет ключ сессии. Бизнес-endpoint используют только Bearer; X-User-Id игнорируется.
История использует keyset-запрос по (chat_id, created_at, id) с индексом idx_messages_chat_created_id. Страница получает limit + 1 строк, а cursor кодируется и подписывается HMAC. PostgreSQL ограничен пулом из 4 соединений; socketTimeout и statement_timeout ограничены 1 секундой, а серверный deadline DB-операции — 2 секундами. При недоступности PostgreSQL или Redis API возвращает ограниченную ошибку 503 unavailable.
Доказательства критериев
| Критерий | Команда/сценарий | Наблюдаемый результат | Доказательство |
|---|---|---|---|
| Контракт и структура | make check |
PASS | |
| Публичный API | make test BASE_URL=http://localhost:8080 |
PASS: lab2 public API scenario | |
| Сохранность | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS: data and existing session preserved | |
| Basic/Bearer, logout, rollback, race | make test-grade4 |
PASS: собственный Python-тест | |
| Истечение TTL | SESSION_TTL_SECONDS=2 docker compose --env-file .env up -d --force-recreate api + make test-grade4-expiry |
PASS: expired session returns 401 | student-tests/lab2.py |
| Недоступность Redis | make test-grade4-redis |
PASS: API returns 503 | student-tests/lab2.py |
| Недоступность PostgreSQL | make test-grade4-postgres |
PASS: API returns 503 | student-tests/lab2.py |
| PostgreSQL history index | EXPLAIN (ANALYZE, BUFFERS) для запроса истории на 10 000 синтетических сообщениях |
Index Scan using idx_messages_chat_created_id, 50 строк за 0.084 ms |
evidence/index-explain.txt |
| Непривилегированный контейнер | docker compose ps, docker exec ... id -u |
UID 10001 | Dockerfile |
Собственные проверки
student-tests/lab2.py проверяет неверный пароль и Basic challenge, запрет Basic на бизнес-запросах, игнорирование X-User-Id, rollback неудачного создания чата, гонку десяти регистраций одинакового username, logout, короткий TTL и ответы 503 при остановке Redis или PostgreSQL.
Ограничения
Это учебный локальный стенд с синтетическими данными. TLS, балансировщик и несколько API-реплик относятся к следующим лабораторным. Redis используется только для сессий; PostgreSQL остаётся источником истины предметных данных. make load показывает closed-loop HTTP-метрики и не является полноценным capacity benchmark.