Validum

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

Validum создаёт вымышленные данные для тестовых стендов. Совпадения с реальными людьми или организациями случайны: пространство ИНН, ФИО и адресов конечно, а справочники взяты из открытых источников. Не загружайте результат в продуктивные системы и не используйте как основание для юридически значимых решений.

Государственные справочники (ED807/ED808, КЛАДР, ОКВЭД-2, коды ЦБ) персональных данных не содержат. Соответствие требованиям 152-ФЗ обеспечивается тем, что в контуре нет боевых данных клиентов, — но ответственность за то, что вы генерируете и куда кладёте, остаётся на операторе.

Три команды — от нуля до данных. Нужен только JDK 21 (или Docker).

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

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

# 3. Тысяча клиентов в CSV / SQL / JSON
java -jar validum.jar generate individual --seed 42 -n 1000 --format csv -o clients.csv
java -jar validum.jar generate individual --seed 42 -n 1000 --format sql --dialect postgres -o seed.sql

Собрать jar: ./gradlew :validum-cli:shadowJar → validum-cli/build/libs/validum.jar.

Тесты jar не пересобирают. После правок кода ./gradlew test обновит только тесты, а java -jar продолжит запускать старую сборку. Перед запуском CLI после изменений — ./gradlew build (он включает shadowJar) или точечно ./gradlew :validum-cli:shadowJar. Признак устаревшего jar: Unknown options: '--…' на опции, которая в коде уже есть.

Пошаговые сценарии под конкретные задачи — в docs/recipes/ (фикстуры в JUnit, заливка в БД, нерезиденты, ДУЛ, ED807/ED808, детерминизм, Docker).

• Быстрый старт
• Зачем нужен Validum
• Ключевые свойства
• Что уже работает
• Четыре способа использовать
• Готовые сценарии
• Каскадные дефолты
• Пакетная генерация (Batch)
• Валидация (Validation API)
• Экспорт (CSV / JSON Array)
• CLI (P3.1)
• Allure Extension (P3.2)
• Явный выбор банка (P3.3)
• Юрлица и ИП
• Полный справочник ЦБ РФ
• Быстрый старт
• REST API
• Java-библиотека
• Архитектура
• Структура репозитория
• Сборка и тесты
• CI
• Docker
• Roadmap
• Для контрибьюторов
• Лицензия

Тестирование банковских систем (АБС) требует данных, которые проходят валидацию:

• ИНН — контрольные разряды по алгоритму ФНС;
• СНИЛС — контрольное число по алгоритму ПФР;
• ОГРН / ОГРНИП — контрольная цифра по алгоритму ФНС;
• КПП, ОКПО — по алгоритмам ФНС/Росстата;
• ОКВЭД-2 — из полного справочника ОК 029-2014 (3069 позиций) вместе с наименованием;
• Расчётные счета — контрольный ключ по Положению Банка России № 809-П;
• БИК и корсчета — из справочника ЦБ РФ.

Проблема:

1. Обычные генераторы (Faker, Mockaroo) выдают поверхностные данные — контрольные суммы не сходятся.
2. Боевые данные нельзя — нарушение 152-ФЗ.
3. Облачные SaaS нельзя в закрытом контуре банка.

Validum решает:

• Генерирует валидные данные — контрольные суммы сходятся.
• Работает внутри периметра — docker compose up и никаких внешних вызовов.
• Обеспечивает воспроизводимость — фиксированный seed.
• Поддерживает каскадные дефолты.
• Пакетную генерацию — до 10 000 профилей.
• 8 эндпоинтов валидации.
• Экспорт — JSON, JSON-массив, CSV.
• CLI без Spring — fat JAR на Picocli (P3.1).
• Allure Extension для JUnit 5 (P3.2).
• Явный выбор банка — .bik / .bank (P3.3).

• Генерация: POST /api/v1/generate/{individual,ip,organization}, GET/POST /scenarios/*.
• Батчи (P1.2): POST /generate/{individual,ip,organization}/batch.
• Валидация (P1.3 + P2.3): 8 эндпоинтов /validate/*.
• Экспорт (P1.4): ?format=json|json-array|csv.
• P3.3: bik в DTO, GlobalExceptionHandler → 400 на IllegalArgumentException.

Fat JAR на Picocli, без Spring (~15 МБ вместе со справочниками КЛАДР и ОКВЭД, старт ~300 мс).

JUnit 5 Extension. @ValidumSeed / @ValidumGenerate → плоский JSON в Allure-отчёте. Только ФЛ.

Документы ДУЛ в этих сценариях: нерезидент с ВНЖ — паспорт иностранного гражданина (10) + вид на жительство (12); иностранец с визой — паспорт (10) + виза; военнослужащий — паспорт РФ (21) + военный билет (07); несовершеннолетний — паспорт РФ (21).

# REST — список сценариев
curl http://localhost:8080/api/v1/scenarios

# REST — пакет из 100 профилей ФЛ в Москве
curl -X POST http://localhost:8080/api/v1/generate/individual/batch \
  -H "Content-Type: application/json" \
  -d '{"count":100,"seed":42,"region":"MOSCOW"}'

# CLI — 100 профилей ФЛ в CSV
java -jar validum.jar generate individual --seed 42 --count 100 --format csv -o profiles.csv
java -jar validum.jar generate individual --seed 42 --as-of 2026-01-01 --format csv -o reproducible.csv

# CLI — 10 ЮЛ типа ГУП в Москве → JSON-массив
java -jar validum.jar generate organization --seed 42 --count 10 --type SE --region MOSCOW --format json-array -o gup.json

// Java-библиотека
IndividualProfile adult = IndividualScenarios.createAdultResidentWithAccount(42L);
IpProfile ip = IpProfileGenerator.generate(
    IndividualProfileGenerator.builder().seed(42L).age(35).build(), 42L);
OrganizationProfile gup = OrganizationProfileGenerator.builder()
    .seed(42L).organizationType(OrganizationType.SE).region(Region.MOSCOW)
    .build().generate();

Фишка Validum: вместо хардкоженных негативных сценариев — ортогональные параметры с умными дефолтами.

• Валидность — дефолт. Порча — только явным параметром.
• Явное значение всегда побеждает auto.
• Параметры ортогональны.
• Мягкие каскады. age=16 + familyStatus=MARRIED → MARRIED.
• Детерминизм с seed. Один seed → один набор данных.
• Детерминизм между днями — asOf. Возраст и сроки документов считаются от даты расчёта: --as-of 2026-01-01 (CLI) или "asOf": "2026-01-01" (REST). Один seed + одна дата дают одинаковый профиль в любой день; без asOf датой считается сегодняшняя.
• P3.3: bank > bik > случайный; невалидный БИК — явная ошибка, не откат.

Один запрос — до 10 000 профилей. Первый использует seed, второй seed+1 и т.д.

POST /api/v1/generate/individual/batch
{
  "count": 100,
  "seed": 42,
  "region": "MOSCOW",
  "categoryClient": "ЗАРПЛАТНИК"
}

P3.3: в батч можно добавить "bik": "044525225" — все профили в пакете получат этот банк.

Ответ (по умолчанию json): { "count": 100, "seed": 42, "profiles": [...] }.

Ограничение: count 1–10 000. Вне — 400 Bad Request.

8 эндпоинтов (P1.3 + P2.3).

# ИНН
curl -X POST http://localhost:8080/api/v1/validate/inn \
  -H "Content-Type: application/json" -d '{"inn":"500100732259"}'
# → { "valid": true, "type": "INDIVIDUAL", "details": "Valid INN checksum" }

# Счёт по 809-П — контрольный ключ зависит от БИК, поэтому передаём оба поля.
# Пара счёт + БИК взята из официального справочника ЦБ (ED807).
curl -X POST http://localhost:8080/api/v1/validate/account \
  -H "Content-Type: application/json" \
  -d '{"account":"30101810145250000440","bik":"044525000"}'
# → { "valid": true, "type": "RUB", "details": "Valid account checksum (письмо 515 / 809-П)" }
#
# Без "bik" проверить нельзя — в ответе будет
# { "valid": false, "details": "Укажите BIK: контрольный ключ зависит от БИК банка" }

# БИК (с названием банка; нужен справочник БИК — шаг 1 быстрого старта)
curl -X POST http://localhost:8080/api/v1/validate/bik \
  -H "Content-Type: application/json" -d '{"bik":"044525225"}'
# → { "valid": true, "type": "BANK", "details": "<название банка из справочника ED807>" }

# ОКПО (P2.3)
curl -X POST http://localhost:8080/api/v1/validate/okpo \
  -H "Content-Type: application/json" -d '{"okpo":"12345676"}'

# ОГРНИП (P2.3)
curl -X POST http://localhost:8080/api/v1/validate/ogrnip \
  -H "Content-Type: application/json" -d '{"ogrnip":"304500116000157"}'

Коды ответа: 200 — проверка выполнена (смотрите valid); 400 — {"error":"invalid_argument","message":"…"} на некорректное значение; 503 — {"error":"bik_source_missing","message":"…"}, если справочник БИК не настроен.

Или из CLI (exit 0/1):

java -jar validum.jar validate inn 500100732259
# → {"valid":true,"type":"INDIVIDUAL","details":"Valid INN checksum"} → exit 0

curl -OJ -X POST "http://localhost:8080/api/v1/generate/individual/batch?format=csv" \
  -H "Content-Type: application/json" -d '{"count":100,"seed":42}'
# → validum-individual-2026-10-22.csv

Что внутри:

• UTF-8 BOM — Excel откроет кириллицу корректно.
• Плоская структура — passportSeries, registrationCity, bankBik, ...
• Экранирование — RFC 4180.

Архитектурно (P3.1a): CsvExporter + 3 флаттенера живут в core (ru.validum.core.export) — используются REST API, CLI и Allure.

Плоская таблица + INSERT для PostgreSQL / Oracle / MySQL — один файл сразу заливается в тестовую БД.

java -jar validum.jar generate individual --format sql --dialect postgres --table clients \
  -n 1000 -o seed.sql
# psql -h localhost -U qa -d testdb -f seed.sql

# Oracle:  --dialect oracle  → CREATE TABLE "clients" ("inn" VARCHAR2(400) ...)
# MySQL:   --dialect mysql   → CREATE TABLE `clients` (`inn` VARCHAR(400) ...)
# --no-ddl                   → только INSERT, если таблица уже есть

Тип колонки выводится из имени: terrorist и blocked — логический (BOOLEAN / TINYINT(1) / NUMBER(1)), age — целое, остальное — текст, чтобы ИНН, СНИЛС и счёт сохраняли ведущие нули. Апострофы экранируются (' → ''), null пишется как NULL. Архитектурно — ru.validum.core.sql (SqlDialect, SqlExporter), без внешних зависимостей.

Fat JAR на Picocli. Без Spring. ~15 МБ со справочниками, старт ~300 мс.

.\gradlew :validum-cli:shadowJar
# → validum-cli/build/libs/validum.jar

java -jar validum.jar --help
java -jar validum.jar version
java -jar validum.jar scenarios

# 1 профиль ФЛ в stdout (JSON)
java -jar validum.jar generate individual --seed 42

# 100 профилей ФЛ в CSV
java -jar validum.jar generate individual --seed 42 --count 100 --format csv -o profiles.csv

# 10 ИП в Москве → JSON-массив
java -jar validum.jar generate ip --seed 1 --count 10 --region MOSCOW --format json-array -o ip.json

# 5 ЮЛ типа ГУП
java -jar validum.jar generate organization --seed 42 --count 5 --type SE --region MOSCOW --format csv -o gup.csv

java -jar validum.jar validate inn 500100732259       # → exit 0
java -jar validum.jar validate inn 500100732258       # → exit 1
java -jar validum.jar validate ogrnip 304500116000157

Паттерн в скрипте:

if ((& java -jar validum.jar validate inn $inn) -and ($LASTEXITCODE -eq 0)) {
    Write-Host "OK: $inn"
}

# Online: скачивает ZIP с cbr.ru, распаковывает
java -jar validum.jar fetch-bik -o data/ED807.xml

# Offline (банковский контур, нет доступа к cbr.ru)
java -jar validum.jar fetch-bik --offline
# → инструкция + exit 0, ничего не скачивает

• --format явный. Не угадываем по расширению.
• Плоский JSON. Те же поля, что CSV. Нужен 1:1 REST — используй REST.
• fetch-bik --offline. Для банковских контуров.
• UTF-8 stdout. Windows-консоль по умолчанию cp866 — форсим UTF-8 в main().
• --output не зависит от консоли. Даже без фикса кодовой страницы файл пишется в UTF-8.

testImplementation("io.github.validum-tech:validum-allure:0.1.0")

@ExtendWith(ValidumExtension.class)
class ClientCreationTest {

    @Test
    @ValidumSeed(42)
    void testCreateClient() {
        // Attachment "Validum Profile" (application/json) в отчёте
    }

    @Test
    @ValidumGenerate(seed = 42, age = 16, region = "MOSCOW")
    void testMinorClient() {
        // Профиль age=16, Москва — в отчёте
    }
}

Что в attachment'е: плоский JSON, те же поля, что CSV (fullName, passportSeries, registrationCity, bankBik, ...). Переиспользуется IndividualProfileFlattener.

Ограничения:

• Только ФЛ (ИП/ЮЛ — P3.2b, если попросят).
• Без Spring. Зависимости: validum-core + allure-jupiter:2.35.3 + junit-jupiter-api + Jackson.
• Best-effort attach. Без Allure runtime — warning в stderr, тест не падает.

По умолчанию банк выбирается случайно из справочника. QA хотят фиксировать «тест со Сбербанком» — теперь это возможно.

// По БИК
IndividualProfile sber = IndividualProfileGenerator.builder()
    .seed(42L)
    .bik("044525225")
    .build().generate();

// Готовый Bank
Bank vtb = BikSources.resolve("data/ED807.xml").findByBik("044525187").orElseThrow();
IndividualProfile vtbProfile = IndividualProfileGenerator.builder()
    .seed(42L)
    .bank(vtb)
    .build().generate();

// ИП наследует через IndividualProfile
IpProfile ip = IpProfileGenerator.generate(
    IndividualProfileGenerator.builder()
        .seed(42L).age(35).bik("044525225").build(), 42L);

# OK → банк Сбербанк
curl -X POST http://localhost:8080/api/v1/generate/individual \
  -H "Content-Type: application/json" \
  -d '{"seed":42,"bik":"044525225"}'
# → { ..., "bank": { "bik": "044525225", "name": "ПАО Сбербанк", ... } }

# 400 → БИК не найден
curl -X POST http://localhost:8080/api/v1/generate/individual \
  -H "Content-Type: application/json" \
  -d '{"seed":42,"bik":"000000000"}'
# → 400 { "error": "invalid_argument", "message": "БИК не найден в справочнике: 000000000..." }

# OK → все профили в CSV с банком Сбербанк
java -jar validum.jar generate individual --seed 42 --count 10 --bik 044525225 --format csv -o sber.csv

# exit 2 → невалидный БИК
java -jar validum.jar generate individual --bik 000000000 --format csv
# → stderr: "Ошибка: БИК не найден в справочнике: 000000000..."

• Приоритет: bank > bik > случайный.
• Невалидный БИК — явная ошибка. Не откатываемся на случайный: REST 400, CLI exit 2.
• ЮЛ с банком. OrganizationProfile содержит bank (БИК из ED807) и account (40702, ключ по 515) — --bank-bik / bik / .bank(...).
• Справочник обязателен. Источник — файл ED807 через BikSources; встроенного демо-набора нет.

ОПФ (7 типов, P2.2):

Композиция над IndividualProfile:

• Всё как у ФЛ (ФИО, паспорт, ИНН 12, СНИЛС, адреса, счёт)
• Отчество — фиксированное «ИП Автотеста»
• ОГРНИП — 15 цифр, валидный по ФНС
• Детерминизм: seed=42 → тот же ОГРНИП
• P3.3: bik работает через base

Справочник обязателен: встроенного демо-набора в продукте нет. Если файла ED807 нет, генерация банковских реквизитов возвращает понятную ошибку (REST 503 bik_source_missing, CLI exit 2), а не подставляет чужие реквизиты.

# CLI (P3.1)
java -jar validum.jar fetch-bik -o data/ED807.xml

# Вручную
curl.exe -o data\newbik.zip "http://www.cbr.ru/s/newbik"
Expand-Archive -Path data\newbik.zip -DestinationPath data\
Rename-Item data\*.xml data\ED807.xml

Парсер: WINDOWS-1251, namespace urn:cbr-ru:ed:v2.0, фильтры PtType="20", PSAC, CRSA, ACAC. Из ~1380 участников — 370 банков (все участники — participants --file).

Одна цепочка на API и CLI (ru.validum.core.bank.BikSources):

1. явный путь — --file, свойство validum.bik.file;
2. переменная окружения VALIDUM_BIK_FILE;
3. системное свойство validum.bik.file;
4. data/ED807.xml.

P3.3: .bik("044525225") ищет банк в загруженном справочнике; не найдено — явная ошибка.

• JDK 21 (Temurin, Corretto, OpenJDK)
• Gradle Wrapper (в репо)
• Docker Desktop (опционально)

git clone https://github.com/Validum-Tech/validum.git
cd validum
./gradlew build

На Windows:

.\gradlew.bat build

.\gradlew :validum-cli:shadowJar
java -jar .\validum-cli\build\libs\validum.jar generate individual --seed 42 --format csv -o profile.csv

./gradlew :validum-api:bootRun

• Swagger UI: http://localhost:8080/swagger-ui.html
• Health: http://localhost:8080/actuator/health

Запрос (полный):

{
  "seed": 42,
  "gender": "MALE",
  "age": 23,
  "passportWasExchanged": false,
  "residencyCountry": "TJ",
  "passportType": "FOREIGN",
  "fioScript": "LATIN",
  "corrupt": ["INN"],
  "region": "MOSCOW",
  "categoryClient": "ЗАРПЛАТНИК",
  "accountPackage": "VIP",
  "familyStatus": "MARRIED",
  "email": "custom@corp.ru",
  "emailDomainMode": "REALISTIC",
  "secretWord": "СЛОН",
  "personalManager": "СЗА02",
  "terrorist": false,
  "blocked": false,
  "bik": "044525225"
}

Ответ (фрагмент):

{
  "fullName": "Кузнецов Александр Владимирович",
  "gender": "MALE",
  "birthDate": "1988-03-12",
  "age": 38,
  "inn": "500100732259",
  "snils": "12345678900",
  "bank": { "bik": "044525225", "name": "ПАО Сбербанк", "corrAccount": "30101810400000000225" },
  "account": "40817810123456789012"
}

• Батчи: POST /generate/{individual,ip,organization}/batch, count 1–10 000, P3.3: bik.
• Валидация: 8 эндпоинтов /validate/*.
• Экспорт: ?format=json-array / ?format=csv.
• Сценарии: GET /scenarios, POST /scenarios/{name}?seed=42.

curl -X POST http://localhost:8080/api/v1/generate/individual \
  -H "Content-Type: application/json" -d '{"seed":42}'

Один и тот же seed даёт идентичный ответ при каждом запросе.

validum-core — чистая Java-библиотека без Spring и внешних зависимостей.

// ФЛ — фасады
IndividualProfile adult = IndividualScenarios.createAdultResidentWithAccount(42L);
IndividualProfile pensioner = IndividualScenarios.createPensionerMale(42L);

// ФЛ — каскады
IndividualProfile minor = IndividualProfileGenerator.builder()
    .age(16).seed(42L).build().generate();

// ФЛ — с конкретным банком (P3.3)
IndividualProfile sber = IndividualProfileGenerator.builder()
    .seed(42L).bik("044525225").build().generate();

// ИП — с детерминизмом
IpProfile ip = IpProfileGenerator.generate(
    IndividualProfileGenerator.builder().seed(42L).age(35).build(), 42L);

// ЮЛ (7 ОПФ)
OrganizationProfile gup = OrganizationProfileGenerator.builder()
    .seed(42L).organizationType(OrganizationType.SE).region(Region.MOSCOW)
    .build().generate();

// Экспорт в CSV (P3.1a)
String csv = CsvExporter.toCsv(IndividualProfileFlattener.flattenAll(List.of(sber)));

// Валидация (P1.3 + P2.3)
boolean innOk = InnValidator.isValidIndividual("500100732259");
boolean ogrnipOk = OgrnipValidator.isValid("304500116000157");
boolean okpoOk = OkpoValidator.isValid("12345676");

┌──────────────────────┐  ┌──────────────────────┐  ┌──────────────────────┐
│  validum-api         │  │  validum-cli         │  │  validum-allure      │
│  (Spring Boot 3.5)   │  │  (Picocli, ~15 МБ)   │  │  (JUnit 5 Extension) │
│  19 REST-эндпоинтов  │  │  8 команд            │  │  @ValidumSeed        │
└──────────┬───────────┘  └──────────┬───────────┘  └──────────┬───────────┘
           │                         │                         │
           └─────────────────────────┼─────────────────────────┘
                                     │ зависит от
                                     ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  validum-core (чистая Java, ZERO-DEP)                                   │
│                                                                         │
│  ФЛ (.bik / .bank) · ЮЛ (7 ОПФ) · ИП (композиция)                       │
│                                                                         │
│  Экспорт: CsvExporter + 3 флаттенера → API, CLI, Allure                 │
│  Валидация: Inn, Snils, Ogrn, Ogrnip, Kpp, Okpo, Bik                    │
│  Стратегии: BikSource · AddressStrategy · FiasMode                      │
│  Каскады: age → passport, region → addresses, category → package        │
│  АБС-специфика: AbsDefaults                                             │
└─────────────────────────────────────────────────────────────────────────┘

Принцип: validum-core не зависит от Spring, БД, сети и внешних библиотек.

validum/
├── validum-core/                  ← 567 тестов (zero-dep)
│   ├── src/main/java/ru/validum/core/
│   │   ├── random/ · common/ · abs/ · inn/ · snils/ · ogrn/
│   │   ├── bank/ · account/ · name/ · passport/ · address/ · contact/
│   │   ├── profile/       ← IndividualProfileGenerator + .bik / .bank
│   │   ├── organization/
│   │   ├── export/        ← CsvExporter + 3 флаттенера
│   │   └── validation/    ← 7 валидаторов
│   └── src/main/resources/  ← names/ · addresses/ · emails/ · secret_words.txt · managers.txt
│
├── validum-api/           ← 80 тестов (Spring Boot)
│   └── src/main/java/ru/validum/api/
│       ├── config/ · controller/ (+GlobalExceptionHandler — P3.3)
│       ├── service/ · mapper/ · dto/
│
├── validum-cli/           ← 55 тестов (Picocli, без Spring)
│   └── src/main/java/ru/validum/cli/
│       ├── ValidumCli · OutputFormat · OutputWriter · BikSourceResolver
│       ├── Generate{Individual,Ip,Organization}Command (+ --bik в individual/ip)
│       └── ValidateCommand · FetchBikCommand · ScenariosCommand · VersionCommand
│
├── validum-allure/        ← 19 тестов (JUnit 5 Extension, без Spring)
│   └── src/main/java/ru/validum/allure/
│       ├── ValidumSeed · ValidumGenerate · ValidumExtension
│
├── data/ED807.xml         ← Справочник ЦБ, НЕ коммитится
├── docs/                  ← README · SCENARIOS · ROADMAP · RELEASING · recipes/
├── docker-compose.yml
└── gradle/libs.versions.toml

./gradlew build         # всё
./gradlew test          # только тесты

На Windows:

.\gradlew.bat build --rerun-tasks

Отчёты: build/reports/tests/test/index.html (тесты) и */build/reports/jacoco/test/html/index.html (покрытие).

CLI fat JAR:

.\gradlew :validum-cli:shadowJar
# → validum-cli/build/libs/validum.jar

Покрытие строк по jacoco (прогон 30.10.2026): validum-core — 91,4% (2360/2581), validum-api — 92,2% (404/438), validum-cli — 65,8% (325/494). Слабейшие пакеты core: validation, common, address; полностью покрыты passport, snils, ogrn, random. HTML-отчёт — validum-core/build/reports/jacoco/test/html/index.html.

GitHub Actions на каждый push / PR в main:

• Ubuntu + JDK 21 (Corretto), кэш Gradle
• ./gradlew build --no-daemon — тесты всех четырёх модулей
• Сводка в Summary: тесты по модулям + покрытие строк (jacoco) для validum-core, validum-api и validum-cli
• Артефакты: HTML-отчёты тестов (14 дней), покрытие jacoco, готовый validum.jar (30 дней)

docker compose up -d
# → Swagger UI: http://localhost:8080/swagger-ui.html

• Multi-stage build: gradle:8.14-jdk21 → eclipse-temurin:21-jre-alpine
• Non-root user, container-aware JVM
• Справочник ЦБ монтируется как volume: ./data:/app/data:ro
• Healthcheck: /actuator/health
• Размер: ~250–350 МБ

DNS (Windows Docker Desktop): если UnknownHostException — Settings → Docker Engine → "dns": ["8.8.8.8", "1.1.1.1"].

• Фундамент, ИНН/СНИЛС/ОГРН/ФИО/паспорта/адреса/счета/БИК
• REST API + Swagger UI + Actuator + Docker
• Каскадные дефолты, флаги, ЮЛ/ИП
• P0.1–P0.3 — ФИО (3,8 млн), адреса из КЛАДР (90 субъектов, 1,99 млн улиц), email/слова/менеджеры
• P1.2–P1.4 — batch, validation, экспорт
• P2.2–P2.3 — 7 ОПФ, ОКПО/ОГРНИП, расширенный КПП
• P3.1 — CLI + CSV в core
• P3.2 — Allure Extension
• P3.3 — .bik / .bank

• 0.2 — транзакции (ED101, выписки ED210/211), справочники ГАР/ОКАТО, OpenAPI + SDK

• P1.1 — первая публикация в Maven Central (код готов, нужны секреты — см. docs/RELEASING.md)
• P2.1 — Транзакции
• P3.4 — Mock API по OpenAPI (3–5 дней)
• P4.2–P4.4 — Иностранные паспорта, Web UI, ML-датасеты
• P2.4 — Банк для ЮЛ — сделано (30.10.2026)
• P3.2b — Allure для ИП/ЮЛ (если попросят)

Как выпускается версия (тег, секреты, Maven Central) — docs/RELEASING.md.

• JDK 21, Gradle Wrapper, IntelliJ IDEA / VS Code
• Java 21 Records, immutable, каскадные дефолты
• Фасады только для 3+ связанных полей
• Тесты: src/test/, имя файла = имя класса, @DisplayName на русском
• Core — zero-dep, CLI и Allure — без Spring
• CSV и флаттенеры — в core
• P3.3: невалидный БИК → явное исключение

1. Форк → ветка feature/my-feature
2. Тесты до реализации
3. ./gradlew build — все 721 зелёные, покрытие не падает
4. PR — CI прогонит сборку на Linux и Windows

Подробности и чек-лист — CONTRIBUTING.md. Уязвимости — не в Issues, а на security@validum.tech (SECURITY.md).

Apache License 2.0 — см. LICENSE.

• GitHub Issues: github.com/Validum-Tech/validum/issues
• Домен: validum.tech
• Организация: Validum-Tech

Validum — данные, которые проходят валидацию. 721 тест. 370 банков. REST API + CLI + Java-библиотека + Allure. P0.1–P0.3, P1.2–P1.4, P2.2, P2.3, P3.1–P3.3, P4.1 закрыты, ДУЛ (11 видов) — в профиле, REST и CLI. 9 КУС-сценариев, экспорт ED807/ED808, Docker.