6.8 KiB
Коллекция Bruno: ручки messenger (lab 2)
Ручной клиент для API: регистрация, Basic-вход, Bearer-доступ, чаты, сообщения
с пагинацией, метрики и негативные проверки. Формат — стандартный Bruno (.bru).
Связанные документы: ../REPORT.md (архитектура и решения),
../evidence/README.md (индекс доказательств),
../.github/pull_request_template.md (сдача).
Как открыть и запустить
# GUI: Collection -> Open -> выбрать папку bruno/ этого репозитория.
# baseUrl уже подставлен на уровне коллекции (collection.bru), вводить его
# в каждой ручке не нужно. Для реального METRICS_TOKEN выберите окружение
# `local` в правом верхнем углу и поправьте metricsToken.
# CLI (требуется @usebruno/cli; запускать из корня коллекции):
npm install -g @usebruno/cli
cd bruno
bru run -r --env-var metricsToken=$(grep '^METRICS_TOKEN=' ../.env | cut -d= -f2)
Проверено на bru 4.2.1 против локального стенда: 29 запросов, 58 проверок,
все зелёные (см. ../evidence/level3-4-verification.md §12).
Стенд должен быть поднят: docker compose --env-file .env up -d --build,
готовность — curl -fsS http://localhost:8080/health/ready.
Переменные и приоритет
| Источник | Что задаёт | Приоритет |
|---|---|---|
collection.bru → script:pre-request |
baseUrl=http://localhost:8080, password=demo-password-123, metricsToken=change-me-metrics-token |
самый низкий: подставляется только если переменная нигде не задана |
environments/local.bru (--env local) |
те же три переменные для конкретного стенда | выше дефолтов |
--env-var name=value (CLI) / runtime-переменные (GUI) |
разовое значение | самый высокий |
Поэтому адрес API больше не нужно вводить в каждой ручке: он берётся из
настроек коллекции. Если metricsToken оставить заглушкой, два запроса к
/internal/* вернут 401 — это ожидаемо и описано в их docs; остальные 26
запросов проходят.
Окружение
environments/local.bru:
| Переменная | Значение по умолчанию | Комментарий |
|---|---|---|
baseUrl |
http://localhost:8080 |
адрес API |
password |
demo-password-123 |
пароль демо-пользователей (12–128 code points) |
metricsToken |
change-me-metrics-token |
возьмите METRICS_TOKEN из .env, иначе запросы к /internal/* вернут 401 |
Порядок выполнения
Папки обходятся по алфавиту, внутри папки — по seq:
auth/ регистрация трёх пользователей и три Basic-сессии, /users/me
chats/ создание чата (два участника), список чатов, чат по id
health/ /health/live и /health/ready
internal/ /internal/metrics и /internal/metrics/reset
messages/ два сообщения, первая страница истории, страница по курсору
negative/ неверный пароль, Basic на бизнес-endpoint, X-User-Id, 404 чужого чата, 400 на limit/cursor,
несуществующую календарную дату курсора и пробельный текст, 409 дубликата
zz-cleanup/ logout и проверка, что отозванный токен даёт 401 (выполняется последним)
Коллекция сохраняет переменные между запросами: suffix, username,
secondUsername, thirdUsername, userId, secondUserId, thirdUserId,
token, secondToken, thirdToken, chatId, messageId, nextCursor.
Повторный запуск не конфликтует с прошлым прогоном: username генерируется
из случайного суффикса, а дубликат проверяется отдельной негативной ручкой.
Что проверяет каждая ручка
auth/register-user.bru— 201, ответ безpassword/password_hash;auth/create-session*.bru— 201,token_type: Bearer,expires_atв UTC,userсовпадает с зарегистрированным;auth/me.bru— Bearer-доступ и совпадение владельца;chats/create-chat.bru— атомарное создание чата с двумя участниками;messages/send-message*.bru—sender_idвыведен из сессии,chat_idверный;messages/history-*.bru—limitсоблюдён, курсор ведёт на следующую страницу и не повторяет элемент;internal/metrics.bru— счётчики и агрегаты латентности без секретов;negative/*— коды и challenge-заголовки, отсутствие подмены владельца черезX-User-Id, 404 вместо 403 для чужого чата, 409 при дубликате username, 400 на невалидные limit/cursor (включая несуществующую дату2026-02-31, которая раньше доходила до SQL и давала 500) и пробельный текст.
Проверка истечения сессии
SESSION_TTL_SECONDS=2 docker compose --env-file .env up -d api
# в Bruno: auth/create-session.bru -> создать сессию, подождать ~2.5 с
# затем auth/me.bru -> ожидается 401 с Bearer-challenge
docker compose --env-file .env up -d api # вернуть штатный TTL из .env
Границы
Коллекция — удобный ручной клиент, а не замена автоматике: контракт и приёмку
проверяют make test, набор из app/test/app.e2e-spec.ts и бенчмарк трека 1
(scripts/track1_cache_benchmark.py). Секретов в файлах нет: пароль и токен
метрик задаются переменными окружения.