zuevav
3fdc526031
- docs/architecture/plan.md — полный план проекта (архитектура, стек, SLA, регуляторика, Реестр ПО, roadmap M1–M5, открытые вопросы и решения). - docs/tasks/README.md — индекс задач и инструкция запуска для Claude Code на dev-ВМ. - docs/tasks/PR-1-go-models-m2m.md — Go-модели M2M, парсер windows-1251, NSDDateTime, round-trip тесты на эталонах. - docs/tasks/PR-2-fansy-ddl.md — DDL принимающей БД для команды Fansy (контракт данных, ETL-требования, словарь полей, тестовые данные). - docs/tasks/PR-3-lk-openapi.md — OpenAPI контракт lk-gateway по ESIA Finance API V1, для синхронизации с командой ЛК. - docs/tasks/PR-4-m2m-core-skeleton.md — FSM сделки, репозиторий, идемпотентность по GUID, метрики SLA. - docs/tasks/PR-5-nsd-adapter-skeleton.md — REST-клиент ИШ НРД, маршрутизация типов пакетов (M2MTR/M2MTD/M2MER/SUBBR/SUBER/SUB16). - docs/tasks/PR-6-crypto-service-skeleton.md — gRPC-каркас Java-сервиса криптографии (КриптоПро JCP, UDS, Provider-абстракция). С этого коммита дальнейшая разработка идёт на dev-ВМ через запущенный там Claude Code. Промпты PR-1..PR-3 готовы к параллельному запуску; PR-4 после PR-1; PR-5 и PR-6 ждут поставку артефактов (ИШ НРД, сертификаты, КриптоПро JCP). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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/<...>— служебные ветви автоматизированных правок.
Лицензия
Внутренняя разработка. Лицензионная модель будет определена при подаче в Реестр российского ПО.