Bridge and Join's — сервис M2M-перевода ценных бумаг через НРД

Внутренний модуль брокера для обмена с НРД сообщениями о переводе ценных бумаг (M2M, ЭДО НРД, сервис MOEX MOST). Реализация — российское ПО, готовится к включению в Реестр (ПП РФ № 1236).

Назначение

Связующий модуль между:

• личным кабинетом клиента на платформе ESIA Finance (источник заявлений инвестора);
• учётной системой Fansy (источник реквизитов и остатков, выгрузка в нашу принимающую БД делает отдельная команда);
• НРД через Интеграционный шлюз / Web-сервис ONYX (формат XML по схемам M2MTransferRequest/Decision/Response/Handbook/ParticipantForm).

Подробное описание архитектуры, потока, регуляторных требований, SLA и дорожной карты — см. docs/architecture/overview.md и план в репозитории команды.

Стек

• Go 1.23+ — ядро (cmd/, internal/).
• Java 21 (Liberica JDK) + КриптоПро JCP — services/crypto-service (XMLDSig по ГОСТ Р 34.10-2012, серверная подпись действий оператора).
• React + Vite — web/admin-ui (журнал, ручное согласование, сертификаты).
• PostgreSQL Pro Certified — основная БД (m2m-core, fansy-store, аудит).
• MinIO — эталоны подписанных XML.
• Развёртывание — одна ВМ внутри контура брокера, podman-compose.

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

• DOC/ — оригинальная документация НРД (схемы XSD, инструкции, эталоны).
• docs/architecture/overview.md — обзор архитектуры.
• docs/fansy-contract/v1/ — DDL и контракт данных для команды Fansy.
• docs/lk-contract/v1/ — OpenAPI контракта с ЛК клиента (ESIA Finance).
• scripts/setup-dev-vm.sh — скрипт первичной подготовки dev-ВМ.

Быстрый старт (на dev-ВМ)

# под admin (один раз на ВМ)
sudo bash scripts/setup-dev-vm.sh

# под dev
git clone https://git.zetit.ru/zuevav/Bridge-and-Join-s.git
cd Bridge-and-Join-s
make build
make test

Ветви

• main — стабильная.
• feature/<имя> — рабочие ветви, в основную через merge request.
• claude/<...> — служебные ветви автоматизированных правок.

Лицензия

Внутренняя разработка. Лицензионная модель будет определена при подаче в Реестр российского ПО.