fontvielle 5fa6ea6ab1 feat(robot): эмулятор робота-автотеста НРД + help-страница + REPORT.md
Реализован внутренний робот-эмулятор в internal/nsdadapter/mock/robot.go.
Источник правил: DOC/instruktsiya-po-testirovaniyu-s-robotom.pdf (от
12.05.2026). Когда mock.Sender видит Header.ReceiverCode == MC0012500000
и DocumentSeries в {1111, 2001, 2002, 3333} — формирует Decision по
выбранному сценарию вместо default-логики.

Сценарии:
- 1111 «Ответ с отказом»: все бумаги Rejection, код ошибки берётся из
  последних 2 символов DocumentNumber (01..09 → M2M01..M2M09)
- 2001 «Принять все бумаги»: все Confirmation; i-й символ DocumentNumber
  = номер депозитария-получателя для i-й секции (1/2)
- 2002 «Принять частично»: 0 = отклонить с M2M05, иначе номер депозитария
- 3333 «Выступить принимающей стороной»: пока только первое сообщение
  (отказ M2M05). Встречный M2MTransferRequest от робота — TODO
  (требует приёмной стороны bj-server)

Тестовые наборы депозитариев (ИНН 7702165310, depcode MC0012500000,
счёт HL2603250011, разделы 31MC0012500000F00 и 36MC0012500000F00)
зашиты в robotDepositary — соответствуют таблице из инструкции.

Help-страница /admin/help/robot с полным описанием: коды робота,
сценарии, управление через DocumentNumber, тестовые данные, коды ошибок
M2M01-M2M09, как переключиться на реальный TEST3 после получения ИШ.

REPORT.md — сводный отчёт для руководства о ходе работ: ~65% общей
готовности системы, ~80% готовности к интеграционному тесту с роботом
(остальное — внешние блокеры: дистрибутив ИШ, сертификат УЦ МБ).
Расписан план первичного тестирования после получения ИШ — 2-3 недели
до продакшена.

.gitignore: исключены DOC/*.pdf.bak (бэкапы doc-watcher'a).
2026-05-14 16:53:52 +03:00
2026-05-05 12:19:14 +03:00

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/<...> — служебные ветви автоматизированных правок.

Лицензия

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

S
Description
No description provided
Readme 44 MiB
Languages
Go 63%
HTML 25.7%
Shell 9.1%
Java 1.9%
Makefile 0.2%
Other 0.1%