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>
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user