Files
Bridge-and-Join-s/internal/nsdadapter/mock
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
..

internal/nsdadapter/mock — заглушка NSDSender

Имитирует Интеграционный шлюз НРД для локальных стендов и сквозных тестов. Реализует интерфейс m2mcore.NSDSender:

  • Send — синхронно возвращает синтетический M2MTransferResponse с StatusCode=INFO и записями 01 по каждой ЦБ.
  • SendDecision — фиксирует и завершает (мы — отправители Decision).
  • Параллельно — спавнит горутину, которая через Config.DecisionDelay (по умолчанию 3 секунды) эмитит M2MTransferDecision в канал Decisions().

Исходы

Через Config.DefaultOutcome или SetOutcome(guid, ...):

  • OutcomeConfirm — Confirmation по всем ЦБ.
  • OutcomeReject — Rejection с кодом Config.RejectionCode (по умолчанию 07).
  • OutcomeTimeout — Decision вообще не приходит (эмуляция SLA-таймаута).

Параметры

cfg := mock.DefaultConfig()
cfg.DecisionDelay = 1 * time.Second
cfg.DefaultOutcome = mock.OutcomeConfirm
sender := mock.NewSender(cfg)

resp, _ := sender.Send(ctx, req)
// resp.StatusCode == "INFO"

decision := <-sender.Decisions()
// Через ~1с прилетает Decision с Confirmation

Подписка на эмитированные Decision

go func() {
    for d := range sender.Decisions() {
        _ = svc.ApplyDecision(ctx, d)
    }
}()

В lk-gateway это делает Server.consumeDecisions (запускается в Run).

Контекст эмиссии

Эмиссия Decision использует внутренний контекст mock'а (создаётся в NewSender через context.Background()), а не контекст HTTP-запроса вызывающего. Это критично — контекст HTTP-запроса закрывается сразу после возврата ответа, и без своего lifecycle мок бы прерывал эмиссию до истечения DecisionDelay. Stop() отменяет внутренний контекст.

Статистика

Stats() возвращает счётчики Sent, Confirmed, Rejected, TimedOut — для admin-страницы lk-gateway.