# 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-ВМ)

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

## Лицензия

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