fontvielle 978777ff6a refactor(cmd): объединить Go-сервисы в один бинарник bj-server
Под выбранный объём 100-1000 сделок/день микросервисная архитектура с
5 отдельными процессами избыточна. Объединяем lk-gateway, m2m-core,
nsd-adapter, notify в один Go-бинарник bj-server. lk-emulator остаётся
отдельным бинарником как QA-инструмент (имитация ЛК ESIA Finance).

cmd/bj-server/main.go:
- Поднимает lkgateway.NewServer (HTTP :8080, REST API + admin UI)
- Фоновый poller NSD ИШ (если задан BJ_NSD_PROFILE)
- Заглушка notify worker (M3-M4: e-mail / Yandex Messenger / WS-push)
- Graceful shutdown через signal.NotifyContext

cmd/lk-gateway/, cmd/m2m-core/, cmd/nsd-adapter/, cmd/notify/ — удалены.

deploy/systemd/:
- bj-server.service — systemd unit для основного сервиса (один файл, простой деплой)
- bj-emulator.service — systemd unit для эмулятора
- README.md с инструкцией по установке (useradd bj, /opt/bj, daemon-reload)

Makefile:
- build теперь собирает только bj-server и lk-emulator
- бывшие пять бинарей удалены

Размер:
- bj-server: 19.5 МБ (включает lk-gateway + m2m-core + nsd-adapter + notify)
- lk-emulator: 12.7 МБ
- общий размер артефактов уменьшился c ~50 МБ до 32 МБ

Внутренние пакеты internal/<...> не изменились — разделение сохраняется
на уровне Go-пакетов, что облегчает возврат к микросервисам если объём
вырастет до 1000+ сделок/день.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 13:46:21 +03:00
2026-05-05 12:19:14 +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%