Self-hosted платформа генерации валидных данных для российского финтеха и госсектора.
ИНН, СНИЛС, ОГРН/ОГРНИП, КПП, ОКПО, БИК и корсчёт из справочника ЦБ, счета по 809-П, паспорта,
адреса из КЛАДР, ОКВЭД-2 — с настоящими контрольными суммами, детерминированно по seed и с
шагом asOf. Core без зависимостей; CLI и REST — тонкие обёртки над ним.
# 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.csvJar ещё не собран? ./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.