Skip to content

Тестирование ​

Проект проверяется на четырёх уровнях: быстрые unit/static checks, интеграция с PostgreSQL, браузерные сценарии, затем deployment/DR проверки в kind. Список тестовых файлов меняется быстрее документации; источники истины — .gitlab-ci.yml, frontend/package.json и каталоги *_test.go, *.test.tsx, frontend/e2e, deploy/helm/nxs-anomaly/tests.

Быстрые проверки ​

Без внешних сервисов:

bash
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 ​

Рекомендуемый локальный запуск:

bash
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_PORT55432порт локального контейнера
NXS_ANOMALY_TEST_POSTGRES_DBnxs_anomaly_testбаза
NXS_ANOMALY_TEST_POSTGRES_USERnxs_anomalyпользователь
NXS_ANOMALY_TEST_POSTGRES_PASSWORDnxs_anomalyпароль
NXS_ANOMALY_KEEP_TEST_POSTGRES01 — оставить контейнер
NXS_ANOMALY_TEST_GO_TEST_ARGS—дополнительные аргументы go test, используются coverage-job
NXS_ANOMALY_TEST_TIMEOUT_SCALE1множитель для 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+:

bash
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:dev

Vitest работает в 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. После намеренного изменения контракта сначала выполните:

bash
cd frontend
npm run openapi:types

Если rolldown сообщает о несовместимом native binding, node_modules был установлен под другую libc/платформу. Нужен чистый npm ci, а не копирование каталога из Alpine в glibc-среду или наоборот.

Browser e2e ​

bash
cd frontend
npm run e2e:install
npm run e2e

Playwright поднимает реальный 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 ​

bash
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.sh

Helm 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 разбит по стоимости, а не в две старые стадии:

  1. static — docs, fmt, version, commitlint;
  2. quality — vet, lint, govulncheck, gosec;
  3. unit — Go/race/security/frontend/OpenAPI/reproducible build;
  4. integration — PostgreSQL coverage, Playwright, restore/PITR/load;
  5. cluster — сериализованные kind-сценарии;
  6. build → package → publish → sign → verify.

Теговый pipeline публикует два image, OCI Helm chart, CycloneDX SBOM и подписи, после чего release:verify проверяет публично документированный pull/render и образы по digest.

Минимум перед merge ​

Для документационного изменения:

bash
git diff --check
# плюс проверка локальных Markdown-ссылок, описанная в README/CI

Для Go/backend изменения:

bash
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.

nxs-anomaly · Documentation