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:
@@ -0,0 +1,52 @@
|
||||
# Архитектура — обзор
|
||||
|
||||
Краткая выжимка из плана проекта. Полный план хранится у разработки в
|
||||
`/.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.
|
||||
Reference in New Issue
Block a user