fontvielle
de41aea00c
Полный клиент Интеграционного шлюза НРД в internal/nsdadapter/igw/:
client.go — REST endpoint'ы по свежей спецификации НРД:
- POST /api/package/{channel}/file — отправка ZIP (Type=archive, File=base64)
возвращает id пакета (поддерживаются варианты id|package_id|ID)
- GET /api/package/status/{id} — статус NEW|SENT|ERROR (с error-полем)
- GET /api/package?channel=&type=M2MTD|M2MER&date=&id=&count=&excludeErrors=
— список входящих от НРД, с files[] и signs[] (ИШ сам проверяет ЭП и
выдаёт VALID|INVALID)
- GET /api/package/{id} — скачать ZIP (raw или base64-в-JSON, авто-детект
по сигнатуре PK\x03\x04)
- Ретраи только на 5xx/сетевые ошибки (4xx — сразу ошибка)
- HTTP-клиент через options, кастомный таймаут, ретраи
pack.go — упаковщик/распаковщик ZIP по разделу 2.3 инструкции:
- PackRequest(req, docName) — M2MTransferRequest→ZIP с config.xml
- PackXML(xml, docName, packageType) — для эталонных сообщений
- UnpackPackage(zip) → {DocXML, WinfXML, Signature, Filenames}
- ParseDecision / ParseResponse через nsdxml.Unmarshal
Покрыто тестами (10/10 PASS):
- send happy path с проверкой формата JSON-body
- retry на 5xx, без ретраев на 4xx
- GetStatus с числовым id
- ListIncoming как массив (новый формат) и как {items:[]} (старый)
- GetPackage raw ZIP + GetPackage с base64-в-JSON
- упаковка/распаковка: 2 файла в ZIP, имена, содержимое config.xml
- распаковка с .sgn и winf.xml
cmd/bj-server/main.go — NSD-poller адаптирован под новый API
(client.ListIncoming(ctx, ListFilter{}) вместо позиционных параметров;
поля Package.ID/Name/Type/State вместо PackageID/PackageType).
Скачана и положена в DOC/ свежая спецификация (798 KB, 15 стр):
DOC/instr-ish-rest-api.pdf — это исходный документ для нашей реализации.
REPORT.md обновлён:
- общая готовность 65% → 70%
- готовность к роботу 80% → 85%
- добавлен раздел про REST-клиент ИШ
- блокер #6 — отсутствие «Руководства по установке ИШ»
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/<...>— служебные ветви автоматизированных правок.
Лицензия
Внутренняя разработка. Лицензионная модель будет определена при подаче в Реестр российского ПО.