zuevav
d5b5597c67
Содержимое первого коммита:
- Структура моно-репо: cmd/{lk-gateway,m2m-core,nsd-adapter,lk-emulator,notify}/,
internal/{m2m,nsdxml,fansystore,notify}/, services/crypto-service/,
web/admin-ui/, deploy/docker-compose/, migrations/, docs/.
- Заглушки main.go во всех cmd/ — make build проходит из коробки.
- Makefile с целями build/test/lint/fmt/vet/tidy/ci/compose-up/compose-down.
- .golangci.yml, .gitignore, README.md (на русском).
- .claude/settings.json — общие ограничения Claude Code для команды
(запрет sudo, rm -rf, доступа к /etc/cryptopro, /var/cryptopro).
- README в каждом каталоге — назначение и стадия (M1..M5).
- docs/architecture/overview.md — выжимка из плана проекта.
- docs/fansy-contract/v1/, docs/lk-contract/v1/ — точки сборки контрактов
с командами Fansy и ЛК клиента.
- deploy/docker-compose/docker-compose.yml — dev-стек (PostgreSQL, MinIO).
- scripts/setup-dev-vm.sh — первичная подготовка dev-ВМ под РЕД ОС 7.x
и Ubuntu 22.04+ (для компаний без бюджета на лицензии); ставит Go 1.23,
Liberica JDK 21, Node.js 20 LTS, Podman, podman-compose, Claude Code CLI;
создаёт пользователя dev, /srv/dev, аудит-history. Идемпотентен.
- scripts/README.md — описание скрипта и ограничений.
Что НЕ коммитим:
- Секреты, ключи, сертификаты — закрыто в .gitignore.
- Локальные настройки Claude Code (settings.local.json) и сессионные
каталоги (.claude/projects/, .claude/worktrees/, .claude/logs/).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
62 lines
3.1 KiB
Markdown
62 lines
3.1 KiB
Markdown
# 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/<...>` — служебные ветви автоматизированных правок.
|
|
|
|
## Лицензия
|
|
|
|
Внутренняя разработка. Лицензионная модель будет определена при подаче
|
|
в Реестр российского ПО.
|