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

Краткая выжимка из плана проекта. Полный план хранится у разработки в
`/.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.