fontvielle
5440ebe152
Файл автоматически читается Claude Code при старте сессии. Содержит: - что это за проект (M2M-переводы через MOEX МОСТ НРД) - текущее состояние + ссылку на REPORT.md - архитектуру обмена с НРД (bj-server → ИШ → ONYX) - структуру каталогов и описание DOC/ - неочевидные решения (КриптоПро CSP, не JCP; PKCS#11; mock-робот; Astra Linux для ИШ; globalRC в admin.go; noProxyClient в news.go) - команды для разработки и запуска - описание дев-стендов (10.10.10.22 РЕД ОС, 10.10.10.27 Astra) - правила (REPORT.md держать актуальным, UI на русском, без emoji если не просили) - что НЕ делать (РЕД ОС для ИШ, JCP вместо CSP, выпуск новых сертов) Это handoff для нового агента — на Astra Linux 10.10.10.27 или на любой другой ВМ — чтобы он не открывал контекст с нуля.
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/<...>— служебные ветви автоматизированных правок.
Лицензия
Внутренняя разработка. Лицензионная модель будет определена при подаче в Реестр российского ПО.