Тестирование
Проект проверяется на четырёх уровнях: быстрые unit/static checks, интеграция с PostgreSQL, браузерные сценарии, затем deployment/DR проверки в kind. Список тестовых файлов меняется быстрее документации; источники истины — .gitlab-ci.yml, frontend/package.json и каталоги *_test.go, *.test.tsx, frontend/e2e, deploy/helm/nxs-anomaly/tests.
Быстрые проверки
Без внешних сервисов:
go test ./...
go test -race ./...
go vet ./...
go build ./...
golangci-lint run --timeout=15m ./...
git diff --checkОбычный go test ./... не должен случайно подключаться к runtime DB. Тесты, которым нужен PostgreSQL, включаются только при NXS_ANOMALY_TEST_DATABASE_URL.
PostgreSQL integration suite
Рекомендуемый локальный запуск:
tests/run_postgres_integration.shСкрипт использует готовый NXS_ANOMALY_TEST_DATABASE_URL либо поднимает одноразовый postgres:17-alpine, ждёт readiness и запускает полный go test. Основные настройки:
| Переменная | По умолчанию | Назначение |
|---|---|---|
NXS_ANOMALY_TEST_DATABASE_URL | — | готовый PostgreSQL DSN |
NXS_ANOMALY_TEST_POSTGRES_PORT | 55432 | порт локального контейнера |
NXS_ANOMALY_TEST_POSTGRES_DB | nxs_anomaly_test | база |
NXS_ANOMALY_TEST_POSTGRES_USER | nxs_anomaly | пользователь |
NXS_ANOMALY_TEST_POSTGRES_PASSWORD | nxs_anomaly | пароль |
NXS_ANOMALY_KEEP_TEST_POSTGRES | 0 | 1 — оставить контейнер |
NXS_ANOMALY_TEST_GO_TEST_ARGS | — | дополнительные аргументы go test, используются coverage-job |
NXS_ANOMALY_TEST_TIMEOUT_SCALE | 1 | множитель для wall-clock дедлайнов сюиты |
Сюите нужна база в единоличном пользовании. Она чистит коллекции и сама крутит worker-циклы, ожидая, что доставки придут на её локальные стенды. Живой worker, смотрящий в ту же базу, заберёт её уведомления себе и доставит их у себя — со стороны это выглядит как падение семи не связанных между собой тестов доставки. Сюита читает heartbeat воркера (тот же, что использует readiness) и отказывается стартовать, если база занята.
Дедлайны сюиты рассчитаны на PostgreSQL рядом с процессом — так устроен CI и так не устроен прод. Через один сетевой хоп запрос стоит ~6.6 мс вместо ~0.6 мс, и тесты начинают падать по часам, а не по поведению. Для удалённой базы поднимите NXS_ANOMALY_TEST_TIMEOUT_SCALE (например, 4).
Suite применяет все миграции 0001–0027 и проверяет реальные транзакции, constraints/индексы, ingest, RBAC, audit, sessions, schedules, maintenance, readiness, personal-data export/erase, retention, delivery/retry, несколько worker-реплик и перенос trace context.
Frontend
Нужен Node.js 22.12+:
cd frontend
npm ci
npm run typecheck
npm run test
npm run test:coverage
npm run build
npm run openapi:check
npm run audit:prod
npm run audit:devVitest работает в jsdom. Набор покрывает страницы alert groups, audit, integrations, maintenance, notifications, readiness, schedules, settings, users, onboarding, notification policies и i18n/Intl formatting для ru-RU и en-US. Coverage thresholds заданы в frontend/vite.config.ts и проверяются test:frontend.
openapi:check заново генерирует TypeScript types из docs/openapi.json во временный файл и сравнивает с frontend/src/api/schema.d.ts. После намеренного изменения контракта сначала выполните:
cd frontend
npm run openapi:typesЕсли rolldown сообщает о несовместимом native binding, node_modules был установлен под другую libc/платформу. Нужен чистый npm ci, а не копирование каталога из Alpine в glibc-среду или наоборот.
Browser e2e
cd frontend
npm run e2e:install
npm run e2ePlaywright поднимает реальный Go API, PostgreSQL и Vite. Сценарии:
- responder flow: вход → ingest → acknowledge → resolve → delivery;
- первичная настройка через UI;
- rotation, override и coverage расписания;
- успешный provider test и permanently failed delivery;
- RBAC и cross-team isolation;
- setup/readiness и отчёт о резервной копии.
Карта и контейнерный запуск для WSL — frontend/e2e/README.md. Suite последовательный: readiness-сценарий меняет общую БД и должен оставаться последним.
Helm, deployment и DR
helm lint deploy/helm/nxs-anomaly
helm unittest -f 'tests/unit/*_test.yaml' deploy/helm/nxs-anomaly
deploy/helm/nxs-anomaly/tests/e2e/kind-smoke.sh
deploy/helm/nxs-anomaly/tests/e2e/kind-networkpolicy.sh
deploy/helm/nxs-anomaly/tests/e2e/kind-kafka-consumer.sh
tests/restore_drill.sh
tests/pitr_drill.sh
tests/run_load_test.shHelm unit tests проверяют workloads, secret modes, production preflight, rate-limit scaling, NetworkPolicy, базы, Istio/Gateway API и acceptance hook. Kind-сценарии исполняют install/upgrade, сетевую политику и реальные сценарии обновления. DR drill-ы проверяют логическое восстановление, PITR, readiness и совместимость предыдущего релиза.
Контрактные и security gates
internal/server/openapi_contract_test.goдвусторонне сверяет реальные routes иdocs/openapi.json, включая suffix/action routes и authz coverage.test:securityотдельно запускает production profile, secret refs, redaction, same-origin, подписи и delivery-honesty regressions.govulncheck,gosec,golangci-lint, frontend audit allowlist и dependency freshness — обязательные CI gates.scripts/check-version.shсверяетVERSION, chart, OpenAPI и release metadata.test:docsпроверяет Markdown/документационные инварианты;test:commitlint— Conventional Commits.
CI
Pipeline разбит по стоимости, а не в две старые стадии:
static— docs, fmt, version, commitlint;quality— vet, lint, govulncheck, gosec;unit— Go/race/security/frontend/OpenAPI/reproducible build;integration— PostgreSQL coverage, Playwright, restore/PITR/load;cluster— сериализованные kind-сценарии;build→package→publish→sign→verify.
Теговый pipeline публикует два image, OCI Helm chart, CycloneDX SBOM и подписи, после чего release:verify проверяет публично документированный pull/render и образы по digest.
Минимум перед merge
Для документационного изменения:
git diff --check
# плюс проверка локальных Markdown-ссылок, описанная в README/CIДля Go/backend изменения:
go test ./...
go test -race ./...
go vet ./...
go build ./...
golangci-lint run --timeout=15m ./...
tests/run_postgres_integration.shДля frontend/API-контракта добавьте npm run test:coverage, npm run build и npm run openapi:check; для chart — helm lint и helm-unittest. Изменения delivery, migrations, topology и восстановления требуют соответствующего integration/kind/drill сценария, а не только unit tests.
Конвенция commit-сообщений — CONTRIBUTING.md.