Files

T

zuevav d5b5597c67 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>

2026-05-05 14:42:18 +03:00

2.9 KiB

Raw Permalink Blame History

Архитектура — обзор

Краткая выжимка из плана проекта. Полный план хранится у разработки в /.claude/plans/precious-percolating-axolotl.md (внешний документ).

Что строим

Внутренний модуль брокера для M2M-перевода ценных бумаг через НРД (сервис MOEX MOST). Сейчас разрабатывается «для себя», но архитектура изначально закладывается под тиражирование другим компаниям.

Состав

lk-gateway — интеграция с ЛК клиента (ESIA Finance API V1).
lk-emulator — эмулятор ЛК на время, пока реальный ЛК не готов.
m2m-core — бизнес-логика и FSM сделки.
nsd-adapter — три транспорта к НРД (ИШ REST — основной, WS ONYX — резерв, ФШ — fallback) и маршрутизация по типам пакетов (#M2MTR/#M2MTD/#M2MER/SUBBR/SUBER/SUB16/Справки/квитанции ЭДО).
crypto-service — Java + КриптоПро JCP, КС1.
notify — уведомления (e-mail, Yandex Messenger 360, WS-push, webhook), архитектура плагинов.
fansy-store — принимающая БД для выгрузки от команды Fansy.
admin-ui — веб-интерфейс администратора и сотрудника депозитария.

Стек

Go 1.23, Java 21 (Liberica JDK), React + Vite + TypeScript.
PostgreSQL Pro Certified (на проде), MinIO.
Развёртывание — одна ВМ, podman-compose.
Класс СКЗИ — КС1 (КриптоПро CSP/JCP).

Ключевые ограничения

SLA: 5 мин/этап на старте, 2 мин/этап в проде. Регуляторный таймаут отсутствия ответа от Брокера 2 — 10 → 5 мин.
Дедлайн прод-релиза — 01.09.2026 (вступление 124-ФЗ + Указания ЦБ).
Реестр российского ПО (ПП-1236) — заявка на M5; стек и архитектура соответствуют.
Кодировка XML — windows-1251; формат NSDDateTime — только МСК-зона.

Документация интеграций

docs/fansy-contract/v1/ — DDL и контракт данных для команды Fansy (мы передаём, ETL делают они).
docs/lk-contract/v1/ — OpenAPI контракта с ЛК клиента.

Развёртывание

deploy/docker-compose/docker-compose.yml — dev-стек (PostgreSQL + MinIO).
scripts/setup-dev-vm.sh — подготовка dev-ВМ под РЕД ОС или Ubuntu.

2.9 KiB Raw Permalink Blame History