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

60 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-таймаута).
## Параметры
```go
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
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.