Skip to content
Validum-TechPublic

About

Генератор синтетических, но валидных по требованиям ЦБ РФ тестовых данных для QA: ИНН, СНИЛС, ОГРН, паспорта, счета по 809-П, БИК из ED807.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Validum

Self-hosted платформа генерации валидных данных для российского финтеха и госсектора.

CI License Java Tests Maven Central core

ИНН, СНИЛС, ОГРН/ОГРНИП, КПП, ОКПО, БИК и корсчёт из справочника ЦБ, счета по 809-П, паспорта, адреса из КЛАДР, ОКВЭД-2 — с настоящими контрольными суммами, детерминированно по seed и с шагом asOf. Core без зависимостей; CLI и REST — тонкие обёртки над ним.

За 30 секунд

# 1. Справочник участников ЦБ (обязателен для банковских сценариев)
java -jar validum.jar fetch-bik -o data/ED807.xml

# 2. Профиль клиента с реквизитами, банком и счётом
java -jar validum.jar generate individual --seed 42

# 3. Тысяча клиентов в CSV, который открывается в Excel
java -jar validum.jar generate individual --seed 42 -n 1000 --format csv-semicolon -o out/clients.csv

Jar ещё не собран? ./gradlew :validum-cli:shadowJar — подробности в QUICKSTART.

Документация

Начать стоит с туториала — один проход «от установки до проверенного набора» на 30–40 минут. Остальное — по мере необходимости.

Документ Когда открывать
Туториал первый раз в проекте
QUICKSTART установка, сборка, тесты, Docker
CLI все команды и флаги
REST HTTP-эндпоинты, форматы, коды ошибок
Интеграции Java-библиотека, JUnit 5 + Allure
Совместимость Java 17+, аддитивность полей, детерминизм
Рецепты готовая команда под конкретную задачу
Возможности зачем нужен и что работает
Сценарии типы клиентов, каскады, поля профиля
Проект архитектура, модули, как участвовать
История версий что менялось и когда

Цифры

Метрика Значение
Тесты 906: 679 core + 114 CLI + 92 API + 21 Allure, 0 падений
Модули core (без зависимостей), cli, api, allure
Поверхность 10 команд CLI, 19 REST-эндпоинтов
Справочник ЦБ около 1,4 тыс. участников, около 370 действующих банков (зависит от выгрузки)
Адреса 90 субъектов, 98,7 тыс. населённых пунктов, ~2 млн улиц, индексы из DOMA.DBF
ОКВЭД-2 3 069 позиций

Лицензия и контакты

Apache License 2.0 — LICENSE. Вопросы и предложения — issue в репозитории; почта dev@validum.tech, сайт validum.tech.

About

Генератор синтетических, но валидных по требованиям ЦБ РФ тестовых данных для QA: ИНН, СНИЛС, ОГРН, паспорта, счета по 809-П, БИК из ED807.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages