chore: каркас моно-репо и скрипт первичной подготовки dev-ВМ

Содержимое первого коммита:
- Структура моно-репо: 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>
This commit is contained in:
zuevav
2026-05-05 14:42:18 +03:00
parent 6222612af2
commit d5b5597c67
25 changed files with 1037 additions and 0 deletions
+61
View File
@@ -0,0 +1,61 @@
# 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/<...>` — служебные ветви автоматизированных правок.
## Лицензия
Внутренняя разработка. Лицензионная модель будет определена при подаче
в Реестр российского ПО.