Files
fontvielle c5695bf0b6 feat(m2m): сквозной поток с веб-интерфейсами — lk-gateway BFF + admin UI + lk-emulator + mock NSD
Реализован M2-шаг-1: первый рабочий сквозной поток M2M-заявки от ЛК
через нашу систему и обратно, с двумя видимыми веб-интерфейсами.

internal/nsdadapter/mock/:
- mock NSDSender с реалистичным синтетическим Response и асинхронной
  эмиссией Decision через настраиваемую задержку (Confirm/Reject/Timeout)
- использует собственный жизненный цикл, чтобы HTTP-контексты вызывающего
  не прерывали эмиссию Decision до истечения DecisionDelay

internal/lkgateway/:
- REST по контракту ESIA Finance V1 (POST/GET/PATCH/list claims)
- admin web UI (/admin/, /admin/claims, /admin/claims/{id}, /admin/status):
  - дашборд со статусом подсистем (postgres, crypto-service UDS,
    nsd-adapter, lk-emulator callback) и счётчиками сделок
  - журнал и карточка заявки с историей FSM, ответом НРД, решением
    принимающей стороны и последним callback'ом
- in-memory SeedStore с 5 тестовыми клиентами и счетами депо
- фоновый consumeDecisions: подписан на mock.Sender.Decisions(),
  применяет ApplyDecision и отправляет PATCH callback в ЛК

internal/lkemulator/:
- имитация ЛК клиента (порт 8083)
- веб-формы: журнал, форма «новая заявка», карточка заявки
- HTTP-клиент к lk-gateway (создание заявки + регистрация callback URL)
- приёмник PATCH callback'ов, локальное хранилище заявок,
  автообновление страницы каждые 3 сек

cmd/lk-gateway/main.go и cmd/lk-emulator/main.go — заглушки заменены
на полные сервисы с graceful shutdown.

Сквозной поток проверен smoke-test'ом: подача заявки через форму
эмулятора → создание сделки в lk-gateway → Send в mock NSD →
эмиссия Decision через 3 сек → ApplyDecision → PATCH callback в ЛК →
эмулятор показывает confirmed. Дашборд lk-gateway: Total=1, Подтверждено=1.

make ci зелёный.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 11:17:11 +03:00

2.9 KiB
Raw Permalink Blame History

internal/lkemulator — имитация ЛК клиента (ESIA Finance)

Веб-приложение, которое играет роль ЛК ESIA Finance в сквозных тестах без подключения к реальному ЛК. Используется:

  • для дев-демо «увидеть как работает сквозной поток заявки M2M»;
  • для приёмочного теста перед интеграцией с реальным ЛК;
  • как QA-инструмент, который остаётся после внедрения реального ЛК.

Веб-страницы

  • / — журнал моих заявок с автообновлением каждые 3 сек (показывает изменение статуса по callback'у от lk-gateway).
  • /new — форма «подать заявку M2M»: выпадающий список инвесторов (из seed-data), реквизиты сторон, ИИС, одна ЦБ, выбор имитируемого исхода (confirm/reject/timeout).
  • /claims/{id} — карточка с историей: тело POST в lk-gateway, ответ lk-gateway, полученный callback, расшифровка ответа НРД.
  • /healthz — health.
  • /api/v1/back_office/claims/{id} (PATCH) — приёмник callback'ов от lk-gateway.

Состав пакета

  • server.go — HTTP-сервер, маршруты, рендер шаблонов.
  • client.goGatewayClient (POST заявка, регистрация callback URL).
  • types.goStore (in-memory) и Claim/CallbackRecord модели.
  • web/templates/layout.html, home.html, new.html, claim.html.

Конфигурация (cmd/lk-emulator/main.go, ENV)

Переменная По умолчанию Назначение
BJ_HTTP_ADDR :8083 Адрес HTTP
BJ_GATEWAY_URL http://127.0.0.1:8080 URL lk-gateway, куда шлём POST заявки
BJ_EMULATOR_PUBLIC_URL http://127.0.0.1:8083 Куда gateway должен слать callback'и (регистрируется при старте)

Сквозной поток для проверки

  1. Запустить ./bin/lk-gateway (порт 8080) и ./bin/lk-emulator (порт 8083).
  2. Открыть в браузере http://127.0.0.1:8083/new.
  3. Подать заявку с дефолтными значениями + исход confirm.
  4. На странице http://127.0.0.1:8083/ через ~3 секунды увидеть статус заявки confirmed.
  5. На странице http://127.0.0.1:8080/admin/ — дашборд lk-gateway со счётчиком «Подтверждено: 1» и заявкой в журнале.
  6. На странице http://127.0.0.1:8080/admin/status — состояние всех подсистем.